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Foreword 



CP/M-8000^ ia A single-u«ttr gttneral purpoa* operating systaa. It is 
d«aign«d for ua« with any disk "based coaputar using a 
Ziiog* 28000'" or eompatibia proceaaor, CP/M-QOOO la aoduiar in 
daaign^ asid can b« modi £i ad to suit ttia naada of a particular 
inatallation. 

Thtt hardwara intartaca tot a particular hardware anvironffianr xa 
aupportad by tha OEM or CP/M-QOOO distributor. Digital 
Raaaarch* impporta tha usar Intartaca to CP/M-dOOO as docuaanted in 
tha CP/M-aoop Oparatinig Systan Oaar's Guida. Digital Raaearch doaa 

not support"'aiiy additiona or modi'Jgica'tibna ' aada to CP/M-QOOO by the 
OEM or distributor. 

Piirpoaa and Audianca 

This laanuai is iatanded to pr«3vida the in£oraation naedad by a 
systama prograamar in adapting CP/M-QOOO to a particular hardware 
anvironiaant. A. substantial dagrsa o£ prograirtaing axpertisa is 
aasuzaed on tha part o£ tha raadar, and it is not expected tnat 
typical usars of CP/M-QOGO will naaid or want tp caad this manual. 

Praraquisitaa and RaXatwd If^uisXicatioiMi 

In addition to this taanual^ tha taadar should ba familiar with the 
architectura of tha Zilog 28000 as daacribad in tha Zilog. I 6 -3 it 
MicroprocQsaor User ' s Manual (.third adit ion)., tha ' C^ / M-QO 
dperatinq Syateia User's Gai'cia > the CP/M-QOOO Qparating Systam 
Proaraffliaar'I's Guide / a.nd* or couraa« the data'iiii of the hardware 
environment where CP/M-8000 is to be implaoantad. Further 

Information on asaeatoly language progra«aiing for tha 28000 amy be 
fiound m Proqraitunxng the 28000 . by Richard Mataoaiai, Sytwtx, 1980. 

BkiM This Book is Orgaalxad 

Section L presents an overview of CP/M-QOOO and daserlbas its nttajor 
components. Section 2 discusses the adaptation of CP/M-QOOO Cor 
/our specific hardware system. Section 3 discusaea bootstrap 
procedures and related information. Section 4 describes each aiOS 
function including entry parameters and return values. Section 3 
describes the process of creating a BIOS for a custom hardwara 
interface. Section 6 discusses how to get CP/M* working for the 
first time on a new hardware environment. Section ? provides 
information on using the distributed version of CP/M-rQOOO. Section 
a describes the PUTBOOT utility, which generates a bootable disK. 
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Appendix A describes the contents of the CP/M-8000 distribution 

disKS. ADoendix B is a listing of the normal and boot BIOS's, 

conditionally compiled. Appendix C contains a listing of the 
PUTBOOT utility program. 
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Section I 
System Oven/lew 



I.l XatrcMGliustxoa - - 

CP/M-SOOO iji a a ingle-us«c ,. genecal purpose opecating aystem Cor 
microcoaputitrs bassd on th« Silog 28000 or equivalent laicropcocasaor 
chip. It is dasigned to be adaptable to almost any hardwace 
environtientr and can be readily cuatonised tlor particular hardwa&e 
jyatea». 

CP/M*8000 ia equivalent to other CP/M syatema with changes dictated 
by the 28000 architecture. In particular, CP/M-aooo supports the 
very large segmented addrass space o£ the zaooo eiunily. 

The CP/M-8000 file fyatara is upwardly compatible with g?/m- 
80'" Version 2.2, CP/M-t«'" Version i.l* and CP/M-68K- Version 1.2. 
The CP/M-aooo file atr.ucture allows files of up to 32 aegabytes per 
file. . CP/M-BOQO supports from one to aixtften disk drives with as, 
many as 512 megabytes per drive. 

The entire CP/M-8000 operating system resides in its own memory 
segment at all times* and is not traloaded at a warm start, cp/M'- 
3000 can be configured to reside in any portion of memory. The 
remainder of the fddrass space is available for applications 
programs^ and is called the transient program area, TPA, The t?a is 
assumed to consist of one or more complete 1.64 Kbyte} memory 
segments « CP/M-SOOO supports both segmented and non-segmented user 
programs, and supports the the splitting of user program and data 
into separate addressing spaces. 

Several eacTOS used throughout this manual are defined in Table 1*1- 



t^blm 1-1.;. :GM*-»SI>II :'1^ra» 



Term 



Meaning 



nibble 

byte 

word 

Longwocd 

address 

physical address 



4-.toit half -byte 

3-bit value 

L6-bit value 

32-bit value 

32-bit identifier of a storage 
location 

address of a location ;.n physical 
memory 
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Table 1-1. 



(contiinued) 



Term 



Meaning 



logical address 



system mode 



nocn&l mode 



offset 



text segment 
data segment 
blocic storage 
segment (28001) 
segmented mode 



non-segmented 
mode 



absolute 
relocatable 



address as issued by a program, 
possibly requiring translation into 
a physical address. 

a program running in system mode can 
execute all instructions, including 
I/O instructions and instructions to 
change the contents of special 
control registers 

programs running in normal mode are 
prevented from executing the so- 
called privileged instructions 

a value defining an address in 
storage; a fixed displacement from a 
base address. For example, the base 
address of segment A£ wr,.th an offset 
of 8000E provides a phvsical address 
of 0A008D00H. 

program section containing machine 
instructions 



program section 

initialized data 

program section 
uninitialized data 



containing 



containing 



set of adjacent memory addresses (up 
to 64K) with the same segment number 

running-state of ;:he segmented CPU in 
which addresses can have different 
segment members 

running-state of the 28000 CPU's. All 
addresses generated by segmented 
CPU ' s in this mode have the same 
segment number 

describes a program that must reside 
at a fixed memory address. 

describes a program which Includes 
relocation Information so it can be 
loaded into memory at any address 
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The CP/M-8000 programming model is described in detail in the CP/M~ 
8000 Operating System Pro*;? rammer ' 3 Guide . After CP/ M-aooO"* is 
loaded in memory, the remaining segments of address space that are 
not occupied by the operating system are called the Transient 
Progrfim Area (TPA). To summarise this programming model briefly, 
CP/M-8C00 supports the following a^aory segments that are not 
occupie\i by the operating system: a user stack, a base page and the 
three program segments « Thciae t]hre« program segments consist of a 
text segment, an initlali2«Hi data segment , and a block storage 
segment (bee). When a progrzia is loaded, CF/M->8000 allocates space 
for these program segments in the TPA. The BDOS Program Load 
Function (59) loads a transient program in the TPA- If memory 
locations are not specified when the transient program is linked, 
the progra^n is loaded in the TPA as shown in Figure l-l. 
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Figure l>i, C?/M-€000 Default »temory Model 
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CP/M-aOOO System Guide i-1 Incroduct.ion 

w'nen a transient program is loaded it may be run m segmented or 
ncn-segmented mode and the address of the transient program (TPA.) 
may be a segmented or non-segmented space. If the TPA is non- 
segmented it may combine or separate code and data, depending upon 
the linker options used to link the program and the space 
requirements of the transient program- Non-segmented transient 
programs may be run either m a single TPA segment space or in a 
segment space split into two spaces: one for instructions and one 
ror data (called split I and D space). The Memory Region Table will 
decide in which physical segments to run the non-segmented program. 
If the program is to run with split instruction and data spaces, two 
pnysical segments are required (with the data, bss, and stack in the 
'same physical segment), otherwise only a single physical segment is 
used. AJ.1 addresses generated by a non-segmented transient program 
will have the same segment number. 

A urogram running in segmented mcxie will be loaded into a segmented 
TPA in which addresses can have different •egment numbers. This 
allows segmented programs to use any segment of the TPA, as 
soecified in their object files. A segmented program requires the 
ai. location Of physical address segments to logical address segments, 
and this is accomplished during link time. 

1 . 2 CP/M-6000 Organization 

CP/M-8000 comprises three system modules: the Console Command 
Processor ( CCP ) , the Basic Disk Operating System (BDOS), and the 
3asic Input/Output System (BIOS). These modules are linked together 
CO form "the operating system. They are discussed individually in 
-his section.. 



1.. 3 MeBory I.ayout. 

Tine CP/M-8000 operating system can reside anywhere m memory. The 
Location of CP/M-8000 is defined during system generation. Typically 
tiie system occupies a segment which is logically separated from the 
T?A. ' See previous Figure 1-1 for an illustration of a logical 
segment separation of the system and the TPA- 

nie TPA for non-segmented programs consists of one to two 64 Kbyte 
segments, one for program code and one for data. Some programs 
expect program code and data to be mixed in one segment. The segment 
in which such programs are run may be the same as or different from 
tlie segments that contain programs with separated program code "and 
data. The TPA for segmented programs consists of up to 128 segments. 
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CP/M-3000 System Guide 1.3 Memory Layout 

The mapping of logical addretsses (which conaiat of a 7-bit segment 
nuonber and a 16~bit offset within a segment) into physical addresses 
ia dontt by ayatem-'Specif ic hardware ^ and the BIOS contains raemory 
aaiiaganent operations to map addresses and copy blocks of memory. 
TIk* ttio fimctiotis for nap addressing and to copy blocks of memos y 
m^e awp^ftir jmd mam cpy. 7ho funetion map^adr translates logicsi. 
ai3dr«s*5s into fhysrcal addj: esses and oem^cpy copies a specified 
liunbar of byte* froai on« physical address to another. 

iSee Flguca 1-1 (CP/M-SOOO Memory Model) fl^pr a discussion of the 
CP/BI-8080 aesrory structure. In this membty ti»del, the CP /M-aooo 
operating systaa resides in the System Memory and is the system 
«ddr«sa space (system operating mode) . The system address space 
ccnabines code and datar since there is no need for the extra space 
provided by code/data separation. The user task has a Transient 
Program Area {T9A) which resides In the normal address space (normal 
operating aocie). The TFA may be segmented or non-segmented. The Sase 
Page is in the highest part of data space and the user stack is just 
below It in data space. 

As discussed ««lier^ raemory locations are addressed by a seven-bit 
segment n\imt»«]; and a sixt»«n-bit offset withih the segment. This is 
not 9 linear but a twO'-dimensional spacer capable of addressing 8 
megaisyteft* Moreover, the System and Normal operating modes can have 
separate address spaces, so that a total of 16 megabytes of physical 
nuHttory cm <^« supported. 

1,4'' CcMGJuiole' jTiii'iiwiiiiiil Prooaasuoc iCXP/) 

The Console Cosnand Processor <> (CCP) provides the user interface to 
CP/M«dOOO. It uses the SOOS to read user oomxaands and load 
programs, and provides several built>in user commands. It also 
provides parsing of eommamd Lines entered at the console. 

1.5 JSMMiie l^isite CIsmratxng Syatm (SDOS? 

The Saaic.jOtartc, Operating iSystem (BOOS) provides 'operating aiystam 
services to, ipplio^tions programs and to the CC?. T%ese include 
character. I/O » disk file I/O (the BDOS disk I/O operations comprise 
the CP/Mo'iOOO file system) , program loading, and others. 
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CF/M-aOOO System Guide 1-5 Basic I/O System ( 310S ) 

1.6 Basic I/O Systex (BIOS) 

T!-ie Basic Inout Output System (BIOS) is the interface between CP/M- 
300C and its'hardware environment. A-Ll physical input and output is 
done bv the BIOS. It includes all physical device drivers, tables 
de-ming disk characteristics, and other hardware specific functions 
and tables. The CCP and BDOS do not change for different hardware 
anvironments because all hardware dependenc ies ' have been 
concentrated m the BIOS. Each hardware configuration needs its own 
BIOS. Section 4 describes the BIOS functions in detail. Section 5 
discusses how to write a custom BIOS. A sample BIOS is presented in 
Appendix B. 

1„7 I/O Devices 

CP/M-8000 recognizes two basic types of I/O devices: character 
devices and disk drives. Character devices are devices that handle 
one character at a time. Disk devices handle data in units of 128 
o^/res, called sectors, and provide a large number of sectors which 
can be accessed m random, nonsequential, order. In fact, real 
svstems night have devices with characteristics different from 
-hese. It is the BIOS' s responsibility to resolve differences 
vj^r;ween the logical device models and the actual physical devices. 

L . 7 . 1 Character Devicee 

Z^aracter devices are input/output devices which accept or supply 
streams of ASCII characters to the computer. Typical character 
devices are consoles, printers, and modems. In CP/M-aoOO operations 
on character devices are done one character at a time. A character 
input device sends ASCII CTRI.-Z (lAH) to indicate end-of-file. 



1.7.2 Disk Devices 

Disk devices are used for file storage. They are organized into 
sectors and tracks. Each sector contains 128 bytes of data. If 
sector sizes other than 128 bytes are used on the actual disk, then 
Mia BIOS must do a logic&l-to-physieal mapping to simulate 12S-byte 
sectors to the rest of the system. Ail disk I/O in CP/M-8000 is 
done in one-sector units. A track is a group of sectors. The 
number of sectors on a track is a constant depending on the 
particular device. The charactsristics of a disk device are 
specified in the Disk Parameter Block for that device. (See 
Section 5 . ) 

To locate a particular sector, the disk, track number, and sector 
number must all be specified. 
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CP/M-8000 System Guide 1-8 System Generation 

1.8 System G«j«ration ax>d <k>id Start Operation 

Generating a OP/M-aoOO ayetea is done by linking together the CCP, 
BOOS, and BIOS to create a fiie called CFM.SYS, which is the 
operating ayatea- Section 2 diacussea how to create CPM.SYS* 
CPH.SYS is brought into a#«ory by a bootstrap loader* which 
typically resides on the fiirat two tracks of a system disk- The 
tera s^tea disk as used hara «eana a disk with the file CPM.SYS and 
a bootstrap loader, c:PMLDR*SYS on the syafeea tracks. Section 3 
discusses the creation o£ a bootstrap loader. 

end' oiC 'S'«iis.tian 1 
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Section 2 
Systejm Generation 



2*1 ChNKr7i«w 



This s«ction d«acrib«« how to build a custom version of CP/M-aoOO by 
combining your BIOS with th« CCP and BDOS supplied by Digital 
R«««arch to obtain a CP/M-aooO operating syataa auitabl* for your 
spaclfic hardwara systam. SitKZtion S dascribes how to craate a 3X0S. 

In thia taction, wa asausMB that you hav* accaaa to an alraady 
configur#d and axacutabla CP/H*QOOO syataa. If you do not, you 
should flrat eaad Saction B„ which diacussea how you can make your 
tizst CP/M-6000 ayaten worK. 

ACP/M-iOOO <^arating #y«ta« ia ganaratad by uaing tha linker. L08K. 
to link . together the ay at ea module a (CCP, IDOS, and BIOS) and bind 
tha ayatea to an abaoluta oiaaory location. The reaulting file la the 
corifigurad operating syataa. It la naaed CPM.SYS. 

2.2 Czmmtixnq CPM.SZ3 

The CCP and BOOS for CP/M«a000 axe diatributad ia. a relocatable 
object code file naaed CPMSnfS.REL, You auat link your BIOS with 
CPMSY9.KEL a«ing the following coaaand: 

A>ij»K -41 -o am,sxs Bxoa.am* cpivsm.sjsL -ioph 

where BIOS.RCL ia the coa^illed or aaaeabled BIOS. This creates 
CPM.SYS, which ia an abaoluta version of your ayatea. 

2.3 ltaX«»c«tixi9 Qtilitiea 

Sihce tha utilities all run in non-aegaentad aode, they do not need. 
to be relocated J they will run in whatever segaenta you have 
aaaigned for the TPA. Sote that the coapiler and linker require 
aeparattt code and data aegaentar all other utilitiea supplied with 
the syataa will run with nonaipiit instruction and data aegaents when 
linked without the '*-i" option of tha linker. 

2;nd of Section 2 
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Section 3 
Bootsti'ap Procedures 



3.1 acN0«»tr«p9iii»9 Ovmerimi 

Sooeatrsp Xotiding i« th« ptotmitm oi bringing fsh« CP/M'-aooo opsratlx&g 
syatam into ouiaory 4l&4 ^«siftg control to it. bootstrap loading is 
Q«c«saarily h*xMw«r9'>*d«pcad«ot, ioiA it Ut ru;rt po«sil3l« to discus* 
all possibia <^ariationft ia this awauaX. lotfMv«r, th« oianual 
pr«««nts a AOd«i of txiotatrappiA^ that ia appIieal>X« to oany 
systaMi, and paxticulArlnf to th« Olivattl* MSO** . 

th« aoiMii of .^»oot«trappiac|f l^hat <«• praaai&t aasuwia that th« cp/m-> 
SOOO Qp«3Ntt;$a^ .ayati^M i« td isa X<»4d«d imto'ttetBorY fsroa a disk: in 
which tha Sirat iiw tjra<;^a (typi«4ily thi. ftrat two) »ra raaarv^d 
£or tha <;^«xi»tih^, ^ataia bootstrap routiiiaa.">fhi'la thm r«»iaind«r ot 
tha dialc «oiiti,4hi' ^« Jiia.,atructura, oonaiptiiiiPf 5>f a i;tiractory and 
disk eilaa* '^'"I'tha 'teApto 'ot diak oci^aaisatioia iu|d piraiMtera is 
diaouaftad ill jiNK^tiiyiO^.'l^ ^ .In our aodai^. «%« ^C^/M'-SOOO oparating 
syatam raaidar.tn 9:,d|,j»k fii* npiwd CPM.St^.' |4«»crib«d in s-sction 
t ) , and tha lyatas , it^eJta etsntain a buk^tati'tp loaidar prcsgraa 
(aatti|MI,52fS) tSmt kja©M#-hfw Jio,r«*d,C?Mr^l«f h^P aaaKs.ry aad transfer 

ootttroi <u»,tfe, _ ^ ..^-i|.^^... ^„,, ^^ *■•' 'v'-,;^'-#^f;^''-'^':. ; .:- 
«o»t ayataiM Titvi ♦''^«ir|i';l6cad«ra aij^l*^? 'MV'*^,% %^^*5*wingi 

1. lAian you praas tntd%^ or <p;aout« ¥!)90^t''00»ii^d firoai a aonitor 
1XM, tha hardwara l^oiidi ODf. or omra , aao^dra ban liming at track 
0, sactor I, iAto tuiaiorY at 4 pradatarttin^d addraaa. and than 
junpa to that «4d3r«a«. 

2. Tha soda; " .?ih«|t . 'caii* «iio«"''i¥|.«l« ""^t.^a^iciS!:^!! \/<'.«ft4' xa now 
ajsuctitiin?*, 4a-ts^i<Niiiy ,* #HJilr:j?f^s^%4p rcrti^Uia''' th*t loads 
tha rtt*t ot ,-th<l aactora '«» '"f&a-'lryataa . lKSJii^c|c4*rldi3fitaining 
CPMX^OR) into anothar pradatar»iii«4' a^<^2faaa in aaaory. and than 
^uopa to that luidraas* l^ota that it yomr binrdwara is saart: 
enough, atapa I aztd 2 can b# conhinad iato orta atap. 

3. Tha coda loadad in a tap 1, which is no%i# axacuting, is the CP/M 
Cold Boot U>ad«r, CPMLiOR* vihich is an abtoravlatad version ot 
CP/M-8000 itsaif , C&MLDR now finds tha iiia C^H.SYS, loads it, 
and jumps to it. A copy oi CPM.SYS is now in naaory. 
axecuting. This compistas tha bootstrapping prooass. 
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:-. order to create a CP/M-8000 diskette that can be booted, you need 
to Know how to create CPW.SYS (see Section 2.2) , how to create the 
GdIc Boot Loader, CPMLDR, and how to put CPMLDR onto your , system 
tracks. You must also understand your hardware enough to be able to 
d^2sign a method for bringing CPMLDR into memory and executing it. 

3.2 Creatii»g the Cold Boot Loader 

CPMLDR is a miniature version of CPM.SYS. It contains stripped 
versions of the .BDOS and BIOS , with only those functions which are 
needed to open the CPM..SYS file and read it into memory. CPMLDR 
exists in at least two forms; one form is the information in the 
svstem trades, the other is a file named CPMLDR. SYS, which is 
created by the linker. The term CPMLDR is used to refer to either 
of these forms, but CPMLDR. SYS only refers to the file. 

CPMLDR. SYS is generated using a procedure similar to that used in 
generating CPM.SYS. That is, a loader BIOS is linked with a loader 
system library, named CPMLDR. REL, to produce CPMJl^DR.SYS. Additional 
modules can* be linked in as required by your hardware. The 
resulting file is then loaded onto the system tracks using the 
PUT300T utility program. 

To perforin the link and load, enter the following command line: 

A> LD8K -W -O CPMLDR-SYS LDEBIOS.HEL CPKLDR.REL -ICPM 

3.2.1 Wcitizi? a Loader BIOS 

The loader BIOS is very similar to your ordinary BIOS; it just has 
fewer functions, and the entry convention is slightly different. 
The following is a list of the differences. 

1. Only one disk needs to be supported. The loader system selects 
only drive A. If you want to boot from a drive other than A, 
your loader BIOS should be written to select that other drive 
when it receives a request to select drive A. 

2. The loader BIOS is not called through a trap; the loader BDOS 
czais an entry point named bios instead. The parameters are 
still passed in' registers, 3"^^ as in the normal BIOS. Thus, 
your Function does not need to initialize a trap, the code 
that in a normal BIOS is the Trap 3 handler should have the 
label _bios, and you exit from your loader BIOS with an RET 
instruction. 
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3. Only the following BIOS functions need to be iaipiemented: 

( lait) Called just once, should initialize hardware as 
necessary, no return value necessary. {?ote that Function 
is called via the _bios label with the function or^st^ber 
«q<»l to 0. You da not need <& separate ^iJiit entry pcxnt. 

4 (Gc«ou«) tJmmd to print error messages during boot. If you 
do zaot want error outssagea. this function should just b« an 
ItST instruction. 

9 (S«ldsk} Called just once, to select drive h, 

10 CS«ttrk) 

11 { Setsec } 

12 (Setdaa) 

13 (Read) 

16 (S«ct£an) 

18 (Set MRT) iTot used now, but might be used In future 
releases. 

22 (Set exees»^i«a) 

4. You do not neeid to includa an allocation vector or a check 
vector « and the Oisk Parameter pleader values that point to 
these- can be anything. However, you still need a Disk 
9axa8M»ter Header. Disk Parameter &lock, and directory buffer. 

tt is possible to use the same source code for both your normal axos 
and your loadar 9X0S if you use conditional cos^i la ti on or assembly 
to di«tlnci|ui9h the two. Appendix 3 provides an example of 
eonditiooaX compilation. 

3.2.2 Waildiiaiq CPIflLDR.STS 

Dree you have written and compiled (or assembled) a loader BIOS, you 
can build CPMLDR.SYS in a aianner very aimiiar to building CPM.SYS. 
There is one additional comialication here: the result of this step 
is placed <ar» the system tracks. So, if you need a small prabooter 
to bring in the bulk of CPMIJDR, the prsbootar must also be included 
in the link you are about to do. The details of what must be done 
are hardware dependent, but the following example should help to 
clarify the concepts involved. 
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Suppose that your hardware reads track 0, sector I, into memory at 
location <<B>>400H when reset is pressed, then jumps to 400H. Then 
vour boot disk must have a small program in that sector that can 
load the rest of the system tracks into memory and execute the code 
^hat they contain. Suppose that you have written such a program, 
assembled it, and the assembler output is in BOOT.O. Also assume 
that your loader BIOS object code is in the file LDRBIOS.REL. Then 
the following command links together the code that must go on the 
system tracks. 

A>LD8K -W -O CPMLDR-SYS BOOT.O LDRBIOS.REL CPHLDR.RBL -/CPM 

Once vou have created CPMLDR.SYS in this way, you can use the 
^U'-BOOT utility to place it on the system tracks. PUTBOOT is 
described in Section 8. The connnand to place CPMLDR on the system 
tracks of drive A is 

A>PUTBOOT CPKLDR.SYS A: 

PUTBOOT reads the file CPKLDR.SYS and outs the result on the 
specified drive. After you have copied CPM. SYS to the disk, you can 
boot from it. 

3.3 Introduction to tbe CP/>*-8000 Target Machine 

^his section presents the Olivetti M20 as a specific microcomputer 
model chosen to implement the CP/M-8000 operating system. The 
difference between the M20 model and the generic model is the 
bootstrapping loader placement. 

The Olivetti M20 uses the Zilog 28001 microprocesor artd is capable 
of supoorting up to 512K bytes of physical memory. The standard 
configuration of the M20 includes a monochrome, bit-mapped display 
screen and two built-in 5 1/4 inch floppy disk drives with a 
caoacitv of 320K bytes each. Optionally, one of the floppy disk 
drives 'can be replaced by a built-in hard disk drive with 8 
meqaoytes of storage. The M20 also has a serial port, which may be 
attached to a line printer or to another computer. 
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3.3.1 N2I1 ataaocY Architectiuxe 

mum iMplmmming o? potting over the CP/M-8000 operating system to 
this Olivetti aZQt tfa* memory architecture of the M20 requires 
p«?:tic«l« attention, P^aical meoiory in the M20 iis configured in 
bmakM of 1«IC byteiseach. "Hse mapping between segmented addresses and 
piiysical vmsmz^ banks is dLone through a RON, and thus is not 
pcogrssBMibl* fey the us«r. 'the «20 contains a menory aiap for a 
configuration with 25€K bytes and a raonochroil#display . One 16K 
ben* i» s«t aside for the bit-mapped display. This memory is 
addressed as segment 3. Segment 4 addresses the bootstrap ROM, and 
Segment 2 is used as 9AH. by ttie ROM* The rest of memory is available 
for program use. Hote that the same banks of physical memory can be 
addressed i» various ways. For instance r segment 8 has a separated 
code and dsts ipaee. Segment 10 has a combined code and data space, 
irhos« physical memory is the same as the segment 8 code space 
physical memory. 

3.3*1 tS»^»^9^^ '|;9|ajiltW»tatioa 

hii"'^^'^'iMi^^^'^^Wi^"*f^* C?/«-8000 operating system resides in 
•M^fasait il, ll'i&o'-««f»«tited as«r programs are loaded into segment 3 if 
■^^•y lfe«iteii«'»'*^?«i'*tS code and data, or into segment 10 if they use 
^'idlisiilld JW^i;'^ 'Jlsts j|f«c«."fhe information describing the type of 
kmkis^\'pti3^tm fi«*ds is, -present tn'tiie first word of the program's 
^;,J,ec% Ilie OHTi ^iik. Hefaented p.rograms are loaded Into whatever 
SMllra»ft't"n«MifS 'are iii"i^«ix object 'file. 

%..3.3^^ Oisiaiy msA Bisk Oci^^ecs 

Ih the M2Q' boots tr if »C3» ace drivsrs for the display screen and che 
disks, -t^e oser «»y ^rite 'H9 own drivers or use the drivers 
-pcov'tdsd here, tlat ??/K-80,ei9 8I0$I0 module invokes the segmented 
emddressiwf jftSde' altsf tfeisfh all of memory is addressable. The 
'IXC^SO module theiii clllls <?|ie ItOH drivers indirectly through a branch 
-table which resides tt a fix«d loostion in the ; ROM, This feature 
makes it uaiiecessACy fee change the a?/M-8000 ^lOSlO module to 
operate compatHaly with «jy future versions of the Olivetti ac»i. 
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3.3.4 Addressing the Screen Bit Map 

Grai=hxcs programs may be implemented easily using the SC #1 memory 
management primitives. The user program builds an image of the bit 
map in a 16K buffer of its own. The user program ^J'^'? "^,^/ "fj^^^^ 
-o' copy that buffer to segment 3, locations ^^'^"^^^h ^i^^^- 
fviternatively , a user program can invoke the segmented addressing 
m;de by executing a mV^dr system call. The P^^^^^^". ,^^«" ^^^^ 
address the bit map memory-directly . The programmer should be aware 
zha:: entering segmented mode has side effects for which the user 
procram must compensate. 

End of Section 3 
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Section 4 
BIGS Functions 



4.1 XntxodiMrticsi 

All C?/M~6000 hardwaro d«pttndencias are concantratad in subcoui^lnss 
that ara colIactiveXy refarrad to as tha Basic I/O Syatao (BIOS) . A 
CP/t*-8000 ayatam iatpiamantoc can tailor CP/M-8000 to fit nearly amy 
ZSOOO oparatin^ anvironttant. This saction daacribas each BIOS 
function: its calling convauntiona r paraaetars, sauA the actiona it 
naiat perform. Tba discuaaion of Disk Daf inition Tables la traatad 
aaparately in Section .S. . 

mien the BDCIS calls a BIOS function, it places the function number 
in registar R3» and function parameters in canisters SR4 and 9R€. 
It then axaeutas 4 SC #3 instruction. R3 is always needed to 
specify the ffunction, but «a«h function has its own requirements for 
other parametars. Specific parameter requirements are provided ta 
the description of aach function. The BIOS uses RRfi to return any 
values to the caller. The sisse of the returned value depends on the 
particular BIOS function. Byte values contained in word or long- 
word length registers arn null padded. 

Hotas The systap call handler in the BIOS nust preserve at litast 
registers RB through RIS. The handlers provided in most BIOS 'a 
preserve ail registers, except for HES which is used to return 
results. Of course # if the BIOS uses interrupts to service I/O, the 
interrupt handlers will need to preserve registers. 

Table 4<«1 sumnarizes BIOS register usage. 

Oser applications typically do not need to make direct use of BIOS 
functions. - Sowever , when acsceas to the BIOS is required by user 
software # it . should use the BDC^ Oirect BIOS Function, Call 50, 
Instead of calling the BIOS with a SC #3 instrueticm. This rule 
ensures that applications cenain compatible with Ifuture systsns. 

The BIOS must also iiMiintain a vector of Exception Sandler addresses, 
through which all system calls and traps are routed. The vector 
numbers have been selected to match the exception used in CP/M-oSK. 
These numbers will be found in the Programmer's Guide. 

Section 4.2 describes the system calls for 23000 memory manageaient. 

The Disk Parameter Header (OPS) and Disk Parameter Slock (DPB) 
formats have changed slightly from previous CP/M versions to 
accommodate the zaOOO's 32-bit addresses. The formats are described 
in Section S. 
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4.1 Introduction 



Table 4—1. BIOS Register Usage 



Enrrv Parameters: 



R3 " function code 
RR4 » first parameter 
RR6 » second parameter 



Return Values 



RL7 ■ byte values (8 bits) 
R7 " word values (16 bits) 
RR6 » longword values (32 bits) 



Tr:.e decimal BIOS f\inction numbers and the functions they correspond 

~o are listed in Table 4-2. 



Ta±il« 4-2. BIOS Punctiona 



Number 



8 
9 

10 

11 



Function 



Initialization (called for cold boot) 

Warm Boot (called for warm start) 

Console Status (check for console 
character ready ) 

Read Console Character In 

Write Console Character Out 

List (write listing character out) 

Auxiliary Output (write character to 
auxiliary output device) 

Auxiliary Input (read from auxiliary 
input) 

Home (move to track 00) 

Select Disk Drive 

Set Track Number 

Set Sector Number 
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4.1 Introduction 



Table 4-2. (continued) 



(fumber 


Function 


12 


Set OMi\ Address 


13 


Read Selected Sector 


14 


vrrite Selected Sector 


15 


Return List Status 


16 


Sector Translate 


18 


Get Memory Region Table Address 


19 


Get I/O Mapping Byte 


20 


Set I/O Mapping Byte 


21 


Flush Suffers 


22 


Set Exception Handler Address 
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Function 



.laiization 



FUNCTION 



INITIALIZATION 



Entry Parameters; 
Register R3: 

Returned Value: 
Register R7 



OOH 



User/DisK Numbers 



B"'QS Function executes the cold bootstrap sequence and initializes 
tiie BIOS, anliice other BIOS functions, this function is not invoked 
w:th an SC #3 instruction. Instead, a jump to the "entry:" label m 
tiie biosboot module invoices this function to execute. The biosboot 
module sets up the PSA svstem segment and system stack pointer, then 
pjraps to the to a location labeled "bios" to invoke this function. 

'^'unction calls trapinit and _biosinit to enable the BIOS. The 
' -raDinit routine Initializes the trap handler table. The _biosinit 
Toutme initializes the hardware and internal BIOS variables. 
Function then transfers control to the CCP. 

"anction returns a longword value. The CC-P uses this value to set 
tnp initial user number and the initial default disk drive. The 
I-ast significant byte of RR6 is the disk number (0 for drive A, 1 
for drive B, and so on) . The next most significant byte is the user 
number. The high-order bytes should be zero. 

Tne entry point to this function must be named bios and must be 
declared global. This function is called only once from the System 
at system initialization. 

For an example of bootstrap code, see the BIOSBOOT. 8KN file on the 
distribution disk. 
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Function 1 



Warm Boot 



FUNCTION 1: WARM BOOT 



Entry Parameters; 

Ragister R3 : OIH 

Returned Value: tTone 



Thia function is called whenever a program terminates. Some 
reinitialization of the hardware or software might occur. When this 
function completes, it jumpa directly to the entry point of the CCP, 
named ^ccp. Note that ^ccp must be declared as a global. 
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Function 2 



Console Status 



FUNCTION 2: CONSOLE STATUS 



Entry Parameters 
Register R3 

Returned Value 
Register R7 
Register R7 



02H 



OOFFH if ready 
OOOOH if not ready 



T^is function returns the status- of the currently assigned console 
device. It returns OOFFH in register R7 when a character is ready 
to be read, or OOOOH in register R7 when no console characters are 

re^ady . 
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FUNCTION 3: READ CONSOLE CHARACTER 

Entry Pareunaters: 

Register R3: 03H 

Returned Value: 

Register R7: Character 

This function reads the next console character into register R7. If 
no console character is ready, it waits until a character is typed 
before returning. 
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FUNCTION 4 : WRITE CONSOLE CHARACTER 



Entry Parameters: 

Register R3 : 04H 
Refgister R5 : Character 

Returned Value: None 

This function sends the character from register RS to the console 
output device. The character is in ASCII. You might want to 
include a delay or filler characters for a line-feed or carriage 
rsturn, if your console device requires some time interval at the 
end of the 'line ( such as a TI Silent 700 Terminal" ) . You can also 
filter out control characters that have undesirable effects on the 
ccnsole device. 
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Function 5: List Character Output 



FUNCTION 5: LIST CH2VRACTER OUTPUT 



Entry Paraa«tars: 

Rttgiflter R3: 05H 

Register R5t Character 

R«tum«<i Value: Nona 



Thia ftmction sands an ASCII character from register RS to the 
currently assigned listing davica. If your list device requires 
scow coBUBunication protocol, it must be handled here. 
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Func-ior. b 



Auxiliary Outpu" 



FUNCTION 6: AUXILIARY OUTPUT 



Entry Parameters 
Register R3 
Register RS 



06H 
Character 



Returned Value: None 



Th^s function sends an ASCII character from register R5 
currently assigned auxiliary output device. 



to the 
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FUNCTION 7 s AUXILIARY INPUT 



Entry Parameters: 

Register R3: 07H 

Returned! Value: 

Register R7 : Character 



This function reads the next character from the currently assigned 
auxiliary input device into register R7. It reports an end-of-fila 
condition by returning an ASCII CTRL-Z (lAH) . 
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FUNCTION 8: HOME 



Entry Parameters: 

Register R3 : OSH 

Returned Value: None 



This function returns the dislc head of the currently selected disk 
to the track 00 position. If your controller does not have a 
special feature for finding track 00, you can translate the call to 
a SETTRK function with a parameter of 0. 
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FUNCTION 9: SELECT DISK DRIVE 



Entry Paraiffietera: 

Regiatar R3: 09H 
Register RS: Oialc Delve 
■ * Register R7: Logged- in Flag 

Returned Value: 

Register RR6: Address o£ Selected 
Drive's DPH 

This function selects the disk drive specified in register RS foe 
further operations. Register RS contains for drive A, I for drive 
3, up to 15 for drive P. 

On each disk select, this function returns the address of the 
selected drive's Disk Parameter Header in register RI16. See Section 
5 for a discussion of the Disk Parameter Header. 

This function must return OOOOOOOOH in register RR6 if a nonexistent 
drive has been indicated in register R5. Although the function must 
return the header address on each call, it is advisaisle to postpone 
the actual physical disk select operation until an I/O function 
(seek/ read, or write) is performed. Disk select operations can 
occur without a subsequent disk operation. Thus, doing a physical 
select each time this function is called may waste time. 

If the least significant bit in register R7 is zero on entry to the 
Select Disk Drive function, the disk is not currently logged in. If 
the disk drive is capable of handling varying media (such as single- 
and double-'Sided, single- and double-density disks) , the 3I0S should 
check the type of media currently installed and then set up the Disk 
Parameter Block. 
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FUNCTION 10: SET TRACK NUMBER 



Entry Parameters: 

Register R3: OAH 

Register R5 : Disk track number 

Returned Value: None 

This function specifies in register R5 the disk track number for use 
m «:ub3ecuent disk accesses. The track number remains active until 

either a'nother Function 10 or a Function 8 (Home) is performed. 

You =an choose to physically seek to the selected track at this 
time, or delay the physical seek until the next read or write 
actaailv occurs. 
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FUNCTION 11: SET SECTOR NUMBER 



Entry ParametAra: 

Ragistar R3s OBH 

Rogiater RS: Sector bTuMter 

Returned Values None 

Thia function apecifiea in regiater RS the sector number for 
subaequent diak acceaaea. Thia number remaina active until Function 
11 ia called again. 

The function seleeta actual (unakewed) sector numbers. If skewing 
ia appropriate, call Function 16 previoua to calling Function 11. 

You can send the sector number information to the controller after 
executing Function 11, or you may delay sector selection until a 
read or write operation occurs. 
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FUNCTION 12: SET DMA ADDRESS 



Entry Parameters : 

Register R3 : OCK 
Register RR4 : DMA Address 

Returned Value: None 

Th.is function contains the DMA (disk memory access) address in 
register RR4 for subsequent read or write operations. Note that the 
controller need not actually support direct memory access. The BIOS 
uses the 128-byte area starting at the selected DMA address for the 
memory buffer during the following read or write operations. This 
function can be called with either an even or an odd address for a 
DMA buffer. 
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FUNCTION 13: READ SECTOR 



Entry Paraaeters: 

Rc^gistar R3: OOH 

R«tuj;ned Value: 

Register R7: if no error 
Register R7: 1 if physical error 

After the drive has been selected, the track has been set, the 

sector has been set, and che DMA address has been specified, the 

Read Sector Function uses these parameters to read one sector and 
'returns the error code in register R7. 

Currently, <;i?/M-aOOO responds only to a zero or nonzero return code 
value. If the value in register R7 is zero, CP/M-aooo assumes that 
the disk operation completed properly. If an error occurs, the 3I0S 
should attempt at least ten retries to see if the error is 
recoverable. 
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FUNCTION 14 



WRITE SECTOR 



Entry Paraneters 
Register R3 
Register R5 



Returned Value; 
Register R7 ; 



OEH 

O«normal write 

l"write to a directory 

sector 
2»write to first sector 

of new block 



0»no error 
l«physical error 



Thi£ function is used to write 128-byte data blocks from the 
currently selected DMA, buffer to the currently selected sector, 
track, and disk. The value in register R5 indicates whether the 
write IS an ordinary write operation or whether there are special 
considerations. 



If register R5«0, this is an ordinary write operation. If R5«l, 
this IS a write to a directory sector, and the write should be 
physically completed immediately. If RS-2. this is a write to the 



«=i -a* 



3t sector of a newly allocated block of the disk. 



The 



signif icajice of this value is discussed in Section 5 under Disk 
Buffering. 
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Function L5 



Return List Status 



FUNCTION IS: RETURN LIST STATUS 



Entry Paraa«tars: 

Registar R3: OFH 

Returned Value: 

Register R7: OOFFH"device ready 
Register R7: OOOOHi^evice not ready 



This function returns the status of the list device.. Register R7 

can contain OOOOK to indicate that the list device is not ready to 

accept a character, or OOFFH to indicate that the list device is 
ready . 
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FUNCTION 16: SECTOR TRANSLATE 

Entry Parameters: 

Register R3: lOH 

Register R5 : Logical Sector Nuxaber 
Register RJ16: Address of Translate 
Table 

Returned Value; 

Register R7 : Physical Sector Number 

This function performs logical-to-physical sector translation, as 
discussed m Section 5.2.2. The Sector Translate function receives 
a logical sector number from register R5. The logical sector number 
can range from to the number of sectors per track minus one. 
Function 16 also receives the address of the translate table in 
register Ril6 . This address must be in the system's address space. 
Tha logical sector number is used as an index into the translate 
taoxe. The resulting physical sector number is returned in R7 , 



if register RR6 « OOOOOOOOH, indicating that there is no translate 
t.a"oie, register R5 is copied to register R7 before Function 16 
re::ums. Note that other algorithms are possible; in particular, it 
is common to increment the logical sector number in order to convert 
the logical sector range of to n-1 into the physical range of 1 to 
n. Sector Translate is always called by the BDOS, whether the 
translate table address in the Disk Parameter Header is zero or 
nonzero. 



4-20 



CP/M-8000 Systam Guide Function IS: G«t Address of MRT 



FUNCTION 13: GET ADDRESS OP MEMORY 

REGION TABLE 

Entry Paraastarss 

Rttgiatar R3: I2H 

Returnad VlLluas 

Ragiatar RR6: Maoory Ration 
TabXa Addrasa 

Thia function ratuma tha addrasa of tha Mantory Region Table (MRT) 
in ragiatar RR6. Tha MRT, which muat ba present and must begin on an 
av«n addraaa. daacribas tha sagnants that coarpose tha TPA for non- 
sagmantad programa. Tha format of the MRT is shown below: 



Entry Count (always ■ 4) 16 bits 

Baaa addraaa of first region 32 bits 

Length of first region 32 bits 

Baaa addraaa of second region 32 bits 

Length of second region 32bit3 

Baaa addraaa of third region 32 bits 

Length of third region 32 bits 

Base addreaa of fourth region 32 bits 

Length of fourth region 32 bits 

Figura 4~1. Maaory Region TaDle Format 
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The regions are: 

Region 1 - the segment used for procrams with merged 
prograLin and data segments: 

Region 2 - the instruction segment for programs with 
split instruction and data segments: 

Region 3 - the data segment for programs with split 
instruction and data segments: 

Region 4 - an instruction segment from which a program 
can access the instructions in region 2 as 
data. 

A program with instructions residing in region 4 can access the 
instructions stored in region 2 as data. The segment number field 
of the program counter of a such a program in region 4 can be the 
seciaent number of region 2. 
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Function 19: Get I/O Byte 



FUNCTION 19: GET I/O BYTE 



Entry Paraaetera: 

Register 613 1 13a 

Returned Value: 

Register R7: I/O Byte Current 
Value 



This function returns the current value of the logical to physical 
input/output device byte (I/O byte) in register R7. This 3-bit value 
associates physical devices with CP/M-3000 ' a four logical devices as 
noted in Figure 4-2. Table 4-3 defines these devices. liilote that 
even though this is a byte value, we are using word references. The 
upper byte must be zero. 

The I/O byte Is split into four 2-bit fields called CONSOLE, 
AlPrrr.TMtY input, auxiliary output, and LIST, as shown in Figure 4-2. 



I/O Byte 
bits: 



Most Significant 
LIST 



Least Significant 



AUXILIAHY AUXILIARY 
OUTPUT INPUT 



CONSOLE 



7,6 S,4 3,2 1,0 



Fignra 4*2. I/O 3yt« Fields 



Peripheral devices other than disks are seen by CP/M-QOOO as logical 
devices, and are assigned to physical devices within the BIOS. 
Device characteristics are defined in Table 4-3. 
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Functiaon 19 



Get I/O Byte 



Table 4-3. CP/M-8000 Logical Device Characteristics 


! Device Name 


Characteristics 


i CONSOLE 

j 


The interactive console that you use 
to communicate with the system is 
accessed through functions 2, 3 and 
4. Typically, the console is a CRT 
or other terminal device. 


LIST 


The listing device, usually a 
printer. 


AUXILIARY OUTPUT 


An optional serial output device. 


AUXILIARY INPUT 


An option&l serial input device. 



The value in each I/O Byte field can be in the range 0-3, defining 
the assigned source or destination of each logical device. The 
vaxaes that can be assigned to each field are given in Table 4-4. 

Note that a Single peripheral can be assigned as the LIST, AUXILIARY 
INPUT, and AUXILIARY OUTPUT device, simultaneously. If no 
peripheral devices are assigned to LIST, AUXILIARY INPUT, or 
AUXILIARY OUTPUT, your BIOS Should give an appropriate error 
message. This prevents system hang-up if the device is accessed by 
PIP or some other transient program. Alternatively, the AUXILIARY 
OUTPUT and LIST functions simply can return to the caller, and the 
AUXILIARY INPUT function can return with a lAH (CTRL-Z) m register 
R7 to indicate an iamediate end-of-file. 
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Function 19: Get I/O Byte 



Table 4-~4. I/O Byte Field Definitions 



CONSOJLE field (bits 1,0) 



Bit 



Definition 



console is assigned to the console printer (TTY:) 

1 console is assigned to the CRT device (CRT:) 

2 batch node: use the AUXZLXARY IHPUT as the CONSOLE 
input, and the LIST device as the CONSOLE output 
(BAT:) 

3 user defined console device (UCl:) 



AUXILIARY INPUT field (bits 3,2) 



Bit 



Definition 



AUXILIARY INPUT is the Teletype device (TTY:) 

1 AUXILIARY INPUT is the high-speed reader device 
(PTRi ) 

2 user defined reader *i (URl:) 

3 user defined reader #2 (UR2:) 



AUXILIARY OUTPUT field (bits 5,4) 



Bit 



Definition 



AUXILIARY OUTPUT is the Teletype device (TTY:) 

1 AUXILIARY OUTPUT is the high-speed punch device (PTP:) 

2 user defined punch fl (UPl:) 

3 user defined punch i*2 (UP2:) 



LIST fieid (bits 7,6) 



ait 



Definition 



LIST is the Telatirpe device (TTY:) 

1 LIST is the CRT device (CRT:) 

2 LIST is the line printer device (LPT:) 

3 user defined list device (ULl:) 



The implementation of the I/O byte is optional, and affects only the 
organization of your BIOS, irhe only CP/M-aooO utilities to use the 
I/O byte are PIP and STAT. PIP allows access to the physical 
devices, STAT allows logical-physical assignments to be aiade and 
displayed. It is good practice first to implement and test your 
BIOS without the lOBYTE functions, thien to add the I/O byte function 
after testing. 
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FUNCTION 20: SET I/O BYTE 

Entry Parameters: 

Register R3: 14H 
Register R5 : Desired 

Returned V&lue: None 

This function uses the value in register R5 to set the value of the 
I/O Byte. See Table 4-4 for the I/O byte field definitions. 
Because this is a byte value, the aost significant byte must be 

zero. 
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Function 21: Flush Buffers 



FUNCTION 21; FLUSH BUFFERS 



Entry Parametars: 

Ragistar R3 : 15H 

Raturnad Valua: 

Ragistar R7; OOOOH-succaasful write 
Ragistar R7: FPFFH^unsuccasatul write 



This function forces tha contents of any disk buffers that have baan 
oodifiad to ba written. After this function haa baen parformad, ail 
disk writaa hava baan physically contpiatad. After the buffers are 
written, this function returns a zero in register R7, Howavar, if 
tha buffers cannot be written or an error occurs, tha function 
returns a value of FFPFH in register R7. 
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FUNCTION 22: SET EXCEPTION HANDLER ADDRESS 

Entry Parameters; 

Register R3 : 16H 

Register R5 : Exception vector Number 

Register RR6: Exception Vector Address 

Returned Value: 

Register RR6 : Previous Vector Contents 

This function sets the exception vector indicated in register R5 to 
the value specified in register Ril6. The previous vector value is 
returned in register RR6. Unlike the BDOS Set Exception Vector 
Function (61), this BIOS function sets any exception vector. Note 

that register RS contains the exception vector number. Thus, to set 
exception #2, segmentation trap, this register contains a 2. 

The exception handler is called as a subroutine, with all of its 
racisters saved on the stacX, in the form given for the context 
block in the Transfer Control instruction. On a segmented CPU, the 
exception handler is entered in segmented mode. It should return 
with a RET instruction. 

Air of the caller's registers except RRO are also passed intact to 
the handler. 



4.2 Menory NanagvnejBt Systea C&lls 

The system call SC il is used for memory management operations: 

mapping addresses from logical to physical, copying blocKs of 
(physical) memory, and transferring control from one address space 
to another. Parameters are specified in registers RE2, RR4 , and 
RR6, and a value may be returned in RR6 . The SC #1 descriptions 
below illustrate the register settings to use when making the calls 
with assembly language as well as the C language calling sequence. 
The C language library contains system call SC *1 functions designed 
to be called from non-segmented C programs. 
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To use the memory management system calls successfully, take care to 
distinguish between logical and physical addresses. A logical 
address refers to an address in a program's address space; it is 16 
bits long for a non-segmented program, and 23 bits long (stored in a 
32-bit word) for a segmented program. A physical address is the 
address of the physical memory which the processor accesses. 'S^o 
cases Illustrate the necessity of this distinction: first, the 
hardware may map a logical address to derive Crom it a physical 
address. Second, a default segment numbet associates with the 
logical addresses of a non-segnentsd program running on a segmented 
CPa. This default segment number is taken ttom the program counter 
(PC) . 

For CPM-aoOO, it is necessary that the logical-to-physical mapping 
process not affect the low-order 16 bits (offset part) of an 
address. Thus, on systems with MMU's that permit segments to start 
on arbitrary boundaries, the apparently "physical" addresses used in 
the BIOS code might be subject to further mapping by the :4MU. So, 
when writing a BIOS for such systems it is necessary to distinguish 
the memory segments which belong to the system addresses from those 
which belong to the T?A. 

BIOS operations done through BDOS call 50 are mapped from the 
caller's address space into physical addresses. 
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SC 



Memory Copy 



SYSTEM CALL 1: MEMORY COPY 



Entry Parameters: 

Register RR2: Length 
Register RR4: Destination 
Register RR6: Source 



Returned Value; 



None 



C language call sequence! 

long source, dest, length; 

/* source: source address, 
dast: destination addrsss. 
length: length of block in bytes. */ 

incm__cpy ( source, dest, length ) 



This operation copies a block of Length bytes from Source to 
Deszination, Length must be greater than zero and lass than 65536 
(a Length of zero is us«d to distinguish different raemory management 
operations). The Source and Destination are segmented physical 
addresses, as provided by the Map Address operation below. 
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SC #1: Map Address 



SYSTEM a\LL I: MAP ADDRESS 

Bntzy Paraffl«t«r9: 

Registar RR2: 

H«giat«r RR4: Spaca Coda 

Regiatar RR6: Logical Addraaa 

Ratumad VaXua: 

Ragistar RR6: Physical Addraaa 

C language call sequenca: 

long addr, paddr; int spaca; 

/"* addr: Logical Address. 
paddr: Physical Address 
(returned value) 
space: Spaca Coda. */ 

paddr • map^^adr ( addr. apace ) 



This form of SC #1 is usad to convert a logical address to a 
physical address. Since logical addresses depend on both the mode 
(system or normal) of the program using tham, and on the spaca being 
accesaad (program or data), a coda datarmines iron which apace to 
map. 

I£ the program in the TPA is running non-segmantad, the Sat TPA 
Sagmant version of'SC #1 will have been used to tall the mapping 
routine which segment is being used. It the TPA is running with 
split program and data, it is also necessary to distinguish bet-waen 
the segment number that goes in the program counter to access 
instructions, and the physical segment by which the TPA's 
instruction sagmant can be accessed as data. 

The space codes are as follows: 



: Caller ' s D^iita Space 

257: Caller's Program Space (as Instructions) 

2: System's Data Space 

3: System' s- Program Space (as Data) 

259: System's Program Space (as Instructions) 

4 : TPA * 3 Da ta Spaca 

5: TPA's Program Space 

261: TPA's Program Space (as Instructions) 



4-31 



CP/M-8000 Svstem Guide 



SC 



Set TPA Segmenr 



SYSTEM CALL 1 



SET TPA SEGMENT 



Entry Parameters: 

Register RR2: 

Register Ril4: OOOOFFFFh 

Register RR6: TPA Base Address 

Returned Value: None 



C language call sequence: 

(TThis function uses the 

laap adr function with 

specTal paxameter values. ) 

long addr , paddr ; 

/* addr: TPA Base Address */ 



iaap_adr ( addr, -I ) 



This operation sets the base segment for a non-segmented program 
running in the TPA. This base address is usually obtained from 
entry 1 in the Memory Region Table for programs with instructions 
and data in the same segment, and from entry 2 for programs with 
split instruction and data segments. 

If R6 (the high-order word of RR6) is FFFFh, the program ruiming in 
the TPA is assumed to be running in segmented mode. 
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SC #1: Transfer Control 



SYSTEM CALL 1: TRANSFER CONTROL 



Entry Paranatars: 

Register HR2: 

Register RB.4: PPFEh 

Register RB.6: Context BlocK Address 

Returned Value: none 



C language call sequence: 

long context; 

/* context: Context Block Address, */ 

xfer (^context ) 



This operation causes control to be transferred to another address 
space. It allows all of the registers to be specified except for 
the system mode stacJc pointer. DDT"* uses this operation to transfer 
control to the program being debugged. - RR6 points to a context 
block of the form: 



word 


RO 




word 


Rl 




word 


R2 




word 


R3 




word 


R4 




word 


RS 




word 


R6 




word 


R7 




word 


as 




word 


R9 




word 


RIO 




word 


Rll 




word 


R12 




word 


R13 




word 


R14 


(normal mode R14) 


word 


RIS 


(normal mode ai4) 


word 


ignored 


word 


FCW 


(Flag/Control Word) 


word 


PC Segment 


word 


?C Offset 
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More tnat the PC segment word is required for compatibility even if 
the CPU IS a non-segmented Z8002. 

End of Section 4 
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Section 5 
Creating a BIOS 



S.l Ovmrvimim 

Th« BIOS providtts a a-tandard Intarfaca to thft physical input/output 
d«vlc«s in your system,. The BIOS intarfaca is dafinad by tha 
functions daacribad in Section 4. Thoaa functional takan togathar, 
const ituta a modal of tha hardwara anvironmant . Elach BIOS is 
tasponaibia for napping that nodal onto tha raal hardwara. 

In addition, tha BIOS conta^ins disk definition tables that define 
tha characteristics of th,e disk davlcaa that ara present, and 
provides soaa storage for use by the BOOS maintaining disk directory 
information. 

Section 4 describes tha functions that must be performed by the 
BIOS, and the external intarfaca to those functions. This Section 
contains additional information describing the structure and 
significance of the disk definition tables and information about 
sector blocking and deblocking. Careful choices of disk parameters 
and disk buffering methods ara necessary if you are to achieve tha 
bast possible performance froa CP/M-3000. Therefore, you should 
read this section thoroughly before writing a custom BIOS. 

S • 2 Disk Dafinition Tables 

fiB in other CP/M systems, CP/M->8000 defines disk device 
charateristics through a set of tablaa. This section describes each 
table and discusses parameter options. 
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5.2 Disk Definition Tables 



5.2.1 Disk Parameter Header 

Each disk drive has an associated 26-byte Disk Parameter Header 
(DPH) which both contains information about the disk drive and 
provides a scratchpad area for certain BDOS operations. Each drive 
must have its ovn unique DPH. The format of a Disk Paranteter Header 
is shown in Figure 5-1. 



XLT 



OQOO 



0000 



0000 



DIRBOF 



DPS 



CSV 



ALV 



32b 



iSb 



16b 



16b 



32b 



32b 



32b 



32b 



Figure S-1. Disk Parawster Header 



Sacn element of the DPH is either a word or longword value. Table 
3-1 gives the meanings of the Disk Parameter Header (DPH) elements. 



Tsible 5-1. Disk Parameter Header Elements 



Element 



Description 



XLT 



0000 
DIRBOT 

DP3 



Address of the logical-to-physical sector 
translation tzible. If there is no translation 
table, it contains the value 0, and the physical 
and logical sector numbers will be identical. 
Disk drives with identical sector translation can 
share the same translate table. Section 5.2.2 
describes the sector translation table. 

Three scratchpad words for use within the BDOS. 

Address of a 128-byte scratchpad area for 
directory operations within BDOS. All DPHs 
address the same scratch pad area. 

Address of a disk parameter block for this drive. 
Drives with identical disk characteristics can 
address the same disk parameter block. 
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5,2 Disk Definition Tables 



Table 5-1. (contiinaed) 



EleiB«nt 



Description 



CSV 



ALV 



AdcSress of a cfasclcsum vector. The BDOS iis«s this 
area to maintain a vector o£ directory checksums 
for the disk. These checksums detect when the 
disk in a drive has been changed. If the disk is 
not ri»iovabla, then it is not necessary to have a 
checksum vector. Sach OPH must point to a unique 
checksum vector. The checksum vector- should 
contain 1 byte for every four directory entries, 
or 128 bytes of directory. The length of the 
checksum vector is equal to (DBM-i'l} / 4. Section 
5.2.3 discusses the DRM value. 

Address of tJie allocation vector, a scratchpad 
area used by the BDOS to keep disk storage 
allocation information. The area must be unique 
for each OPH* There must be one bit for each 
allocation block on the drive. This requires 
that the length of the allocation vector be equal 
to (DSH/S) > 1. Section 3.2.3 discusses the DSM 
value. 



5.2.2 Sectoc Translate Table 

Sector translation in CP/M-6000 is a method of Logically renumbering 
the sectors on each disk track to improve disk I/O performance. 
Frequently programs must access disk sectors sequentially. Sowevec, 
in reading sectors sequentially, most programs Lose a full disk 
revolution between sectors because there is not enough time between 
adjacent sectors to begin a new disk operation. To alleviate this 
problffiB, the traditional CP/M solution is to create a Logical sector 
numbering scheme in which logically sequential sectors are 
physically separated. Thus, between two logically contiguous 
sectors, there is a rotational delay. The sector translate table 
defines the logical-to-phyaical mapping for a particular drive. 

Sector translate tables are used only within the 3I0S, and may have 
any convenient format. The only Interaction the BDOS has with the 
table is to Cetch the sector translate table address £rom the OPH 
and to pass that address to the Sector Translate Function of the 
aiOS. The most common form for a sector translate table is an n- 
byte or n-word array of physical sector numbers, where n is the 
number of sectors per disk track. Indexing into the table with .the 
logical sector number yields the corresponding physical- sector 
number. 
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5.2 Disk De£init.ion Tables 



Alc-^ough you may choose any convenient logical-to-physical mapping, 
there is a nearly universal mapping used in the CP/M community for 
sinale-sided, single-density, 8-inch diskettes. That mapping is 
shown in Figure 5-2. Your choice of mapping affects diskette 
compatibility among' different systems. To make your mapping 
compatible with different systems, we recommend the mapping shown in 
Figure 5-2. 



Logical Sector 
Physical Sector 



Logical Sector 
Physical Sector 



12 3 4 

1 7 13 19 25 



5 6 7 8 
S 11 17 23 



9 10 11 12 
3 9 15 21 



13 14 15 16 17 18 19 20 21 22 23 24 25 
2 8 14 20 26 6 12 18 24 4 10 16 22 



Pigurs 5-2. Smmplm S«ctor Traxislattt Tabic 



5.2.3 Diak Para»«t«r Biodc 

A Disk Parameter Block (DPB) de.fino» several characteristics 
associated with a particular disk drive. These include the size of 
the drive, the number of sectors per tracK, and the amount of 
directory spactt. 

One or more DPH's may use a common DPB if the diskia are identical in 
definition.. Figure 5-3 shows the DPB format. Table 5-2 describes 
the DPB field*. 



! SPT 



16b 



3SH 



ab 



BLM 



Sb 



EXM 



8b 



DSM 



ato 16b 



DRM 

16b 



Reserved 

16b 



CKS 



16b 



FF : 



OFF 



16b 



Pigiure 5-3. Dislc P&rajMiter Blodc 
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5.2 Di3lc Definition Tables 



Each field is a word or a byte value. Table 5-2 describes each 
field. ■-: 



TiablA 5-2, Disk ParauMtar Block Ftmlda 



Field 


Definition 


SPT 


Number of 12a-byte logical sectors per track. 


BSB 


The block shift factor , deternined by the data 




block allocation size, as shown in Table 5-3. 


BLM 


The block mask* determined by the data block 




allocation size, as shotm in Table 5-3. 


EXM 


The extent mask, determined by the data block 




allocation size and the number of disk blocks r as 




sho%m in Table 5-4. 





Reserved byte. 


OSM 


Determines the total storage capacity of the disk 




drive and is the number 'bf the Last block, zero 




relative. The disk contains OSM-»-i blocks. 


ORM 


Oeterminea the total number of directory entries 




that can be stored on this drive. ORM is the 




number of the last directory entry, zero 




relative. The disk contains DRM+i directory 




entries. Each directory entry requires 32 bytes. 




For maximum efficiency the value o£ ORM should be 




such that the directory entries exactly fill an 




integral number of allocation units. 


CKS 


The size of the directory check vector. The CKS 




value is sero if the disk is permanently loounted. 




The CKS value is equal to (ORM) / 4 ■*• I for 




removable media. 


OFF 


The nuiober of reserved tracks at the beginning of 




a Logical disk. This is the number of the track 




on which the directory begins. 
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In order, to select appropriate values for the Disk Parameter Block 
eiemencs, you must understand how disk space is organized in CP/M- 
8000. A CP/M-8000 disk has two major areas: the boot or system 
tracks, and the file system tracks. The boot tracks hold a machine- 
dependent bootstrap loader for the operating system. They consist 
of tracks to OFF-1. Zero is a legal value for OFF, and in that 
case, there are no boot tracks. The usual value of OFF for 8-inch 
floppy disks is two. 

The tracks after the boot tracks, beginning with track number OFF, 
conta::n the disk directory and disk files. Disk space in this area 
as grouped into units called allocation units or blocks. The block 
sise for a particular disk is a constant, called BLS. 

BLS can take on any one of these values: 1024, 2048, 4096, 8192, or 
16384 bytes. Mo other values for BLS are allowed. Note that BLS 
does not appear explicitly in any BIOS table. However, it 
determines the values of a number of other parameters. The OSM 
field in the Disk Parameter Block is one less than the number of 
blocks on the disk. Space is allocated to a file or to the 
directory in whole blocks. No fraction of a block can be allocated. 

The cnoice of BLS is very important. It affects the efficient use 
of disk space. There is a minimum value of BLS that allows an 
entire disk to be used. Each block on the disk has a block number 
from to DSM. The largest block number allowed is 32767. 
Therefore, the largest number of bytes that can be addressed in the 
file system space is. 32768 * BLS. Because the largest allowable 
value for BL.S is 16384, the disk capacity that CP/M-800 can access 
is -.6384*32768 » S12 Mbyt«s. 

Each directory entry can contain either 8 block numbers, if DSM is 
greater than or equal to 256, or 16 block numbers if DSM is less 
than 256. £ach file ne«ds sufficient directory entries to hold the 
block numbers of all blocks allocated to the file. A large value 

for BLS implies that fewer directory entries are needed. If fewer 
directory entries are used, directory search time is decreased. 

The disadvantage of a large value for BLS is that files are 
allocated BLS bytes at a time, and there is potentially a large 
unused portion of a block at the end of the file. If there are many 
small files on a disk, the waste can be significant. 

The 3SH and BLM parajneters in the DPB are functions of BLS. Once 

you have chosen BLS, use Table 5-3 to determine BSH and BLM. The 

£XM peirameter of the DPB is a function of BLS and DSM. Use Table 

5-4 to find the value of EXM for your disk. 
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5.2 Disk Definition Tables 



Tabla S-3. 



BSH euod BLM Values 



3L5 


BSH 


BLM 


1024 


3 


7 


2048 


4 


15 


4096 


5 


31 


8192 


6 


63 


16384 


7 


127 





Tabl* 


5-4. 8XM 


Valuaw 






BLS 




OSM <« 


2S5 






DSM 


> 255 


1024 
2048 
4096 
3192 

16384 






1 
3 

7 
IS 








N/A 

1 
3 

7 



Th« ORM entry in thai DPB is one lees than the total number of 
directory ^^ntries. Choose a ORM value large enough so that you do 
not run out of directory entries before running out of disk space. 
It is not possible to give an exact rule for determining OHM because 
the nusber of directory entries needed depends on the number and 
sixes of the files present on the disk. 

The CKS entry in the DPB is the byte count of the checksum vector - 
The CSV field of the OPH points to the checksum vector. If the disk 
is not removable, a checksum vector is not needed, so this value can 
be zero. 

5.3 Oisie Bloekia? 

When the BOOS performs a disk read or write operation using the 
BIOS, tUie unit of information read or written is a 12a-byte sector. 
This night correspond to the actual physical sector size of the 
disk. If not, the BIOS oust implement a method of representing the 
12a-byte sectors used by CP/M-aOOO on the actual device. Usually if 
the physical sectors are not 128 bytes long, they are some taultiple 
of 128 bytes. Thus, one physical sector can hold some integer 
number of 128-byta CP/M sectors. In this case, any disk I/O 
actually transfers several CP/M sectors at once. 
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It might also be desirable to perform disk I/O in units of several 
126-byte sectors to increase disk throughput by decreasing 
rotational latency. Rotational latency is the average time it takes 
for the desired position on a disk to rotate around to the read- 
write head. Generally this averages 1/2 disk revolution per 
transfer. Because much disk I/O is sequential, rotational latency 
can be greatly reduced by reading several sectors at a time, and 
storing them £or future use. 

In both the preceding cases, the point of interest is that physical 
I/O occurs in units larger than 128-byte sectors. • Section 5.3.1 
discusses methods of performing disk I/O in units larger than L28- 
byte sectors. 

5.3.1 A SlJBplc Approach 

This section presents a simple approach to handling a physical 
sec cor size larger than the 128-byte logical sector size. The 
method discussed in this section is a starting point for refinements 
discussed m the following sections. Its simplicity makes it a 
logical thoice for a first BIOS on new hardware. However, the disk 
throughput that you can achieve with this method is poor, and the 
refinements discussed later give dramatic improvements. 

Probably the easiest method for handling a physical sector size that 
is a multiple of 128 bytes is to have a single buffer the size of 
the physical sector internal to the BIOS. Then, when a disk read 
occurs the physical sector containing the desired 128- byte logical 
sector is read into the buffer, and the appropriate 128 bytes are 
copied to the DMA address. Writing is a little more complicated: 
you must put data into a 128-byte portion of the physical sector, 
but you can only write a whole physical sector. Therefore, you must 
first read the physical sector into the BIOS's buffer, copy the 128 
bytes of output data into the proper 128-byte piece of the physical 
seczor in the buffer,, and finally, write the entire physical sector 
back to disk. 

Note: This operation involves two rotational latency delays in 
ackj-ition to the time needed to copy the 128 bytes of data. In fact, 
the second rotational wait is probably nearly a full disk 
revolution, since the copying is usually much faster than a disk 
revolution. 
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5.3.2 So— !Ui£lnea«ats 

Thsra ar« aany mathods you may usa to linprova tha parforaemca of the 
algorithm of Saetion 5.3.1. Tha first aathod is basad on tha fact 
that disk accassaa ara usually dona saquantiAlly. Thus, if data 
froB a cartain physical aac tor is naadad, it is likaly that anothar 
piaca oi that sactor will ba naadad on tha naxt disk oparation. To 
taka advantaga of this fact, tha SIOS can kaap information with its 
physical sactor buffar as to which disk, track, and physical sactor 
(if any) is raprasantad in tha buffar. Than, whan raading, tha BIOS 
aaad only parform physical disk raads whan tha data naadad is not in 
tha buffar. 

Whan parforming disk writaa, tha SXOS still naads to praraad tha 
physical sactor for tha saaa raasons discussad in Saction 5.3.1. 
Onca tha physical sactor is in tha buffer, subsequent writes into 
that physical sactor do not require additional prereada. To save 
additional disk accesses, do not write the sector to the disk until 
absolutely necessary. Section 5.3.4 discusses tha conditions under 
which the physical sactor stust ba written. 

5.3.3 Traek Saffaring 

Track buffering is a special case of disk buffering where the I/O is 
done a full track a4: a tia«. This method is quite good when 
mifficient manory for several full track buffers is available. This 
method eiq»loys the following differences from that discussed In 
Section 5.3.3. First, transferring an entire track is much mora 
efficient than transferring a single sector. The rotational latency 
is incurred only onca for die entire track, whereas if the track is 
transferred one sactor at a time, tha rotational latency occurs once 
per sector. On a typical diskette with 26 sectors par track, 
rotating at 6 revolutions per second, the difference in rotational 
latency par track is about 2 seconds versus a twelfth of a second. 
Of course, in applications where the disk is accessed purely 
randomly, there is no advantage because there Is a low probability 
that more than one sactor will ba used from a given track, ilota 
that such applications are extremely rare. 

5.3.4 Least Rfeoently aaed Buffar RapXace s w in t 

vrith any method of disk buffering using more than one buffer, it is 
necessary to have an algorithm to manage the buffers. A buffer 
should be filled when there is a request for a disk sector that is 
not presently in memory. 
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Generally, it is desirable to defer writing a buffer until it 
becomes necessary. Thus, several transfers can be done to a buffer 
for tine cost of only one disk access, or two accesses if the buffer 
must be preread. There are four reasons why buffers must be written 
back to disk: 

1. When a BIOS Write operation with »ode«l (write to directory 
sector ) has been invoked. It is very important to the 
integrity of the CP/M-8000 file system that directory 
information on the disk is kept up to date. Therefore, ail 
directory writes should be performed immediately. 

2. A BIOS Flush Buffers operation. This BIOS function forces all 
disk buffers to be written. After performing a Flush Buffers, 
It IS safe to remove a disk from its drive. 

3. A disk buffer is needed, but ail buffers are full. Therefore a 
suffer must be emptied to make it available for reuse. 

4. A Warm Boot occurs. This is similar to number 2 above. 

Case three above is the only case in which the BIOS writer has any 
discretion as to which buffer should be written- The best strategy 
is to write out the buffer that has been Least Recently Used. The 
fact that the contents of a buffer have not been accessed for some 
time is a fairly good indication that it will not be needed afain 
soon. 

5.3.5 Tbe Bew Elocdc FIA9 

As explained in Section 5.3.2, the 8DOS allocates disk space to 
files in blocks of BLS bytes. When such a block is first allocated 
to a file, the information previously in that block need not be 
preserved. To enable the BIOS to take advantage of this fact, the 
3D0S uses a special parameter when calling the BIOS Write Function. 
This special parameter is indicated when register R5 contains the 
value 2 on a BIOS Write call, then the write being done is to the 
first sector of a newly allocated disk block. Therefore, the BIOS 
need not preread any sector of that block. If the BIOS performs 
disK buffering in units of BLS bytes, it can mark any free buffer as 
corresponding to the disk address specified in this write. This is 
because the contents of the newly allocated block are unimportant. 
If the BIOS uses a buffer size other than BLS, then the algorithm 
for taking full advantage of this information is more complicated. 
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Proper use of this flag reduces disk delay. Consider the case 'where 
one file is read sequentially and copied to a newly created fi^e. 
Without this flag, every physical write would require a praread. 
With the flag, no physical write requires a preraad. Thus, the 
number of physical disk operations is reduced by one third, 

End of Section 5 
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Section 6 

Installing and Adapting the 

Distributed BIOS and CP/M-8000 



6.1 Chrwrvitm* 

Digital Rtts«arch auppliss CP/M-SOOO in a £ora suitabl« for boating 
on an Olivetti M20 aystan. If you have an Olivetti M20v you can 
read Section 6.2, which tells how to load the distributed system. 
Similarly, you can buy or lease some other machine that already runs 
CP/M-QOOO, 

If you do not have an Olivetti M20/ you can use the .REL files 
supplied with your distribution disks to bring up your first CP/M- 
8000 system. Section 6.3 discusses this process. 

6.2 Sooting on an Olivetti M20 

The CP/M-QOOO disk set distributed by Digital Research includes 
disks to boot and run a?/M-a000 on the Olivetti M20. You can use 
the distribution system boot disk without modification if you have 
an Olivetti (M20 system with the following configuration: 

e 2S6K memory (minimum re<quired by the Olivetti memory management 
scheme ) 

e at least two double sided 5 1/4" floppy drives, or one double 
sided 5 L/4" floppy drive and one 5 1/4" hard dish. 

To load CP/M-aOOO on a system with two floppy drives, do the 
following: 

1. Place the disk in the first floppy drive. 

2. Press the SYSTEM RESET button (on the right hand side of the 
machine) . 

3. Type "F". This will cause the system to boot from floppy drive 
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Tc load CP/M-8000 on a system with one floppy and one hard disk 
drive, do the following: 

1. Insert the Olivetti PCOS " system disk into the floppy drive. 

:.. Press the SYSTEM RESET button to boot PCOS. 

:. , 'Type "vf 10:" and a carriage return to format the hard disk. 

'- . Insert the CP/M-SOOO distribution disk into the floppy drive, 

■>. Press the SYSTEM RESET button, then type "T" . CP/M-8000 will 
boot . 

sj . Type "ERA C;*.*" and a carriage return to clear the hard disk 

directory. 

1. You oay then use PIP to transfer files to the hard disk. 

6.B Bringing Op CP/M-6000 Using the CPMSYS.RJEL Piles 

The CP/M-8000 distribution disks contain a copy of the CP/M-8000 
operating system m relocatable object code form, for use in 
bringing up CP/M-8000 on any ZBOOO system. The relocatable CP/M- 
8000 system is in the CPMSYS.REL file. This file contains the CCP 
and BDOS, but no BIOS. Release notes amd/or a file named README-DOC 
describe the exact characteristics of the CPMSYS.REL file 
distributed on your disks. To bring up CP/M-8000 using the 
CPMSYS.REL file, you need: 

• a method to down-load absolute data into your target system 

• a computer capable of reading the CP/M-8000 distribution disks, 
such as the Olivetti M20 

• a C language BIOS written for your target computer. This BIOS 
aay be developed from the C language BIOS supplied on the CP/M- 
3000 distribution disks. Typically you will need to modify all 
the BIOS modules, and to write a new 3I0SI0.C module. 

G:.ven the above items, you can use the following procedure to bring 
a working version of CP/M-8000 to your target system: 

1. Compile your BIOS on the Olivetzi M20 . 

2. Link CPMSYS.REL and your new BIOS.REL files on the Olivetti 
M20. Section 2 describes this process. 

1 . Down-load your new CP/M system created in step 2 to the target 
comouter . 



&-2 



CP/M-8000 Syatam Guide 6.3 CP/M-8000 with CPMSYS.REL 

Now that you have a working version of CP/M-8000, you can use the 
tooij provided with the distribution system for further deveioprndnt . 

End of Section 6 
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Section 7 
Cold Boot Automatic Command Execution 



7.x Ov«]rvl«ii 

Th« Cold Boot Autoaatic Coauaand Sxacution foature of CP/M-dOOO 
allows you to conf igura CF/M-8000 so that the CCP will automatically 
axacuta a pradetarmined coasiand lin* on cold boot. This £«atura can 
b« ua«d to start up tum~te«y systania. 

7.2 S«t;tixig up Cold Boot AutoKatic Cowand Sxaeutioa 

Tha CBACS feature uses two global symbols: ^autost, and ^usercimi. 
Thesa are both defined In the CCP, which uses them on cold boot to 
determine whether this feature is enabled. I£ you want to have a 
CCP command automatically executed on cold boot, you should include 
code in your BIOS's cold boot routine (at the label "bios") to 
perform the following: 

1. Set the byte at _^autost to the value OIH. 

2. The command line to be executed must be placed in memory 
beginning at the usercmd location. The command must be 
terminated with a MXJLl (OOH) byte, and toay not exceed 128 bytes 
in length. All alphabetic characters in the comzoand line 
should be upper •case. 

Once you write a BIOS that performs these two operations, you can 
build it into a CPM.SYS £ile as described in Section 2. This 
system, when booted, will execute the command you have built into 
it. 



End of Section 7 
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Section 8 
The PUTBOOT Utility 



3.1 POTBOOT Qp«rati<^ 

Th« PUTBOOT Utility eoplaa a bootstrap Loadar prograa fron a £ils to 
th« syataa tracks of a disk. 

8.2 Invoking PUTBOOT 

Invoka PUTBOOT with a conmand of tha form: 

PUTBOOT <fil«najaa> <driv9> 
whare 



• <filanantt> Is tha nana of tha fxia to be written to the system 
tracks; 

• <driva> is the drive specifier for the drive to which 
<fiienaaa> is to ba written (letter in the range A-P.) 

PUTBOOT writes the specified file to tha system tracks of the 
specified drive. Sector skewing is not used; the file is written to 
tha system tracks in physical sector nuober order. 

Because the system tracks for the Olivetti M20 must have some 
special PCOS information on them, PUTBOOT contains logic to add that 
information to tha system file placed on the system tracks. 

PUTBOOT issues massages indicating successful or unsuccessful 
execution of the copy operation. The tnassages indicating successful 
execution are 

Bootstrap file is x bytes. 
This indicates tha size of the boot £ila. 

Bootstrap has been written. 
This indicates the operation is compLete. 
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The messages indicating errors in the PUTBOOT execution are 

putboot: Illegal drive code <drive> 

Tills indicates an illegal drive code in the <drive> specifier on the 
coaixaand line. 

putboot: Can't open bootstrap file <filenaiDe> 

Tyn.i indicates that PUTBOOT cannot open the file specified in 
<t:iLename> on the command line. 

Bootstrap too big. 

Thi3 indicates the file specified on the conuaand line is too big to 
be ropied to the system tracks. 

usage: putboot <filename> <crivecode> 

This indicates that the command line had an argument error. 

?':t30CT uses BEXDS calls to read the bootstrap loader program stored 
ir. tne file specified m <fiienaa»e>, PUTBOOT uses BIOS calls to 
wrize tne bootstrap program to the system tracks. It refers to the 
OFF and SPT parameters m the' Disk Parameter Slock to determine the 
3i;:e of system track space. The source and command files for 
PUTBOOT are supplied on the distribution disks for CP/M-8000. 

End of Section 8 
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APPENDIX A 
Contents of Distribution Disks 



This appendix descrlbQS briefly the files on the diskettes that 
contain CP/H-8000 as distributed by Digital Research. 



Pile 



Contents 



AR8R.Z3R 
ASZ8K.P0 
ASZ8K.Z8K 
XC0N.28K 

3I0S.REL 

LORBIOS.REL 

a IDS. SUB 

3IOSBOOT.8KN 
3IOSDEFS.8K1I 
3IOSIP.3KN 

aioszo.aKN 

BI0SMEM.3KN 

3IOST!lAP.8KN 

3I0S,C 



Executable vecslon of the acchiver/librarian. 

Ptedefinition file foe the assembler. 

Executable version of the assembler. 

Executable version of the XCON utility. The 
.XCON utility tranaiatas Crora UNIDOT object file 
format to XOOT object file foriaat. 

A relocatable code £ile containing the 3I0S for 
the Olivetti M20. 

k relocatable code file containing the loader 
3I0S for the Olivetti M20 

A submit file which creates a relocatable 
BIOS.HEL Sile. 

BIOS boot code. 

BIOS assembly definitions £or BIOS modules. 

BIOS interface code. 

BIOS I/O routines. 

BIOS memory management routines. 

3I0S trap routines'. 

C language source of Spotstrap and normal BIOS 
for the Olivetti H20 . 
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1 



Contents 



SYSCALL.8KN 
COPY.ZSK 
C?M . SYS 

C?!^.SYS.REL 

CP^:S YS 2. REL 

CPMLDR.REL 

CPKLDR.SYS 

CPHSYS.SOB 
DDT. Z8K 

DUHP.Z8K 

FORMAT. Z8K 

F?E.O 

FPEOEP.O 



Interface for system calls m 3I0S for Z8001. 

An executable version of the COPY utility. 

Executable CP/M-8000 operating system file for 
the Olivetti M20. 

Relocatable version of CP/M-8000 containing the 
CCP and BDOS modules. 

Relocatable version of CP/M-8000 for the ZB002. 
Contains the CCP and BDOS modules. 

Relocatable bootstrap loader for the H20. 
Contains only BDOS module. 

The bootstrap loader for the M20. h copy of 

this is written to the system trades using 
PUTBOOT . 

k submit file to create CPM.SYS. 

An executable version of DDT, the interactive 
debugger . 

An executable version of the DUMP utility. 

An executable version of the ED utility. 

An executable version of the dis< formatter 
utility for the Olivetti M20 . 

Object file for floating point processor 
emulator. Lintced into normal BIOS. 

Object file for processor dependent floating 
point processor emulator code. Linked into 
normal BIOS. 
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Pile 



Contents 



LDBOOS . REL 

LDSK.ZSK 

LIBCPH.a 

LIBCPMS.a 



OPT.O 
OPT.C 
OPTl.O 
OPTI.C 



Loader BOOS relocatable object file. 

Executable version of linker/ loader 

C language runtiae library for the Z8QQ2. 
Functions execute in non-segmented mode. 

C language runtime library for the Z8001. 
Functions execute in segmented mode. 

Object and C lauiguage versions of C language 
library optimization facilities. The file 
OPTION. H contains commentary explaining these 
facilities. 



OPTION. H 

CTY?E.H 

ERRNO.H 

PORTAB.H 

SET JMP . H 

SIGNAL. H 

STDIO.a 

XOUT.H 

ASSERT, H 

MAKSLDR.SUB 

.MKPUTBT . SUB 

2IMZSK.Z3K 

PIP.Z8K 



The following files prefixed " . H" are C 
language declarations to be used in the BIOS or 
other user programs via the C language 
"include" directive. 

Declarations to eliminate unused C runtime 
library functions. 

iMaicro definitions for ASCII coded integers. 

Declarations of error codes. 

Declarations for BIOS portability. 

Declarations for setjrap and longjmp functions. 

Declarations for the signal function. 

Declaration of C standard I/O functions 

Declarations of CP/M-aooo object format. 

Declaration of the ASSERT macro. 

Submit file to create CPMLDR.SYS. 

Submit file to create PUTBOOT. 

Executable version of the symbol table dump 
utility. 

An executable version of the PIP utility. 
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Concents 



PUT BOOT. C 
PUT300T.Z8K 

TPJ-. . 
■RUxDyLE 

si::E2aK.Z8K 

STARTUP , 

ST.\ilTUP.aKN 
STARTUP . 8KS 
STAT.SSK 
XDJMP.Z8K 



u w. w . 4i) O Fv 

ZCC1.Z8K 

i<Cw2 . ZSK 
1>C»3 . Z5)c 



C language source of ::he Olivetti PUTBOOT 
utility. 

Executable version of the Olivetti PUTBOOT 
utility. 

Ob^ject code specific to the Olivetti M20 . 
PUTBOOT uses this code - 

An ASCII file containing information relevant to 
this shipment of CP/M-aoOO. 

ExecutaJDle version of SIZE28K utility. 

Startup routine for use with C programs. 
STARTUP must be the first object file linJced. 

STARTUP. SKN is for the 28002. 

STARTUP. SKS is for the 28001. 

An executable version of the STAT utility. 

Executable version of XDUMP utility. XDUMP is 
iiice DUMP, and prints additional header and 
symbol table information. 

The C language compiler and its overlays. 



End of Aooendix A 



A-4 



APPENDIX B 
Sample BIOS Written in C 

Tha I i a tings in this app«ndix are also £ound on your CP/M-6000 
distribution disk. 

Th« Olivetti BIOS consists of both C language and asaambly coda. 
Tha C language coda is conditionally compilad to produce either a 
loader BIOS for use with CPMLOR.SYS or a normal BIOS £or use with 
CPM.SYS. Listing B-l is the C lamguage BIOS. Listings B'-2 and B-3, 
BIOSASM. 8KII and LBI0SA5M.3KN, assefflble the seven resnaining assembler 
nodules to form either a normal BIOS or a loader BIOS, based on the 
value o£ the label "LOADER" . 

Listing El-I. C Language BIOS 

/•1 ."/ 

/•I CP/M-aOOOUa) aiOS Cor eh* OWVBTTl M20 (Z8000) ! •/ 

/•I 1-/ 

/•I Copyright L984, Digital Bmrnmiucch Inc. 1'/ 

/y i*/ 

/ * I ■ !■ ■ii w iiiii w ■iii w a w i ■ i i iin iii i i i ii i iiiii n I III.II.I ■ * / 

/* CoBpilatisB inforsation */ 

/To eeaplla bios.e Cor cpaldr.Ay« thm eonaand isi tee -a -Ml -dLOAJQER bioa.c */ 
/*This conditionally ci^pil** Otoa.c l««vinq unractuirad cod* out ot tha obiact*/ 
/•tila. V 

/ •■■.■■.■lll,«l... -.1 — , I.. I,.,,-.,. «». — .■,-,.,. „ ,. ■ .!■■■ I I, I. , ■.■ ■ , 11. I . . . .I , 1 . I. .,. II .,■« ■ . . ...... — ....^..-..^ • / 

/* Tha noraal bxoa ceaplla eomand Cor cpa. aya i»t zee -e -Ml bioa.e '/ 
/* This will provida eha Cull Cunccionallxty oiC tha bloa in zhm ob^aet Cila */ 

/* ay coapiling bioa.e Mith clta coamand : sec -e -MI -dTRAMSTBSt bioa.e */ 

/* You ara providad wich a Dioa ofijact chat 4llowa tha two Cloppy driv«a to */ 

/* hava cvio dl££arant formats. This i* Imtt puraly aa an axaepia Cor cha */ 

/* tha banafit ot porting to a diC£arant Coraat and can b« aodiClad. */ 

/* ay coapiling bioa.e with tha coaaandi tee -e -Ml -daact26 bioa.c */ 

/* 3" Cloppy diak support is arovxdad by conditional coapilation. */ 
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Listing B-i. (continued) 



Joefine BAUD 1 

ide£in« DEBUG i 

.'■ copyrightCJ " 
il STORY 

320803 S. 
330614 f. 



• / /• D«co«B«nting this define will condicionaiiy coBOiie"/ 
/* coo* scccing che zzy porx to 1.200 D«ud li,at«nin9 */ 
/• XOTT on that port, "/ 

*/ /* By dacoBMcncing chii Amtin* hard disk dabug^ing ■/ 
/• IB enaoied. Tnit provxdo* dri.v«, biock, and •/ 
/' cracfc intoraation to ba printeKi on tha conaoia. */ 

'Copyright 1984 Digital Raaaareh Inc.": 



Savitz>cy (Ziiog) — d«riv»d tzam 68000 CXORHACS bioa 

Zlouiiek (Ziiog) — raaovod initialisation of lobyta 
upon aach Maraboot. Changad aaXdiak to teat £or 
ovwrilow of th« dphtab (so fix cj»« "£.!.{ d:' bug). 



330804 F. slotnicJc (Ziiog) — Added conditional coBpilacion tor 
loader aiOS. which only naadt a £■«« o£ tha BIOS 
functions. The ioadar DOZS raquira tha dafinition 
of a contaxt asructurt. for zrAnaimt of control to 
tha syataa propar. 

. Ilotnick (I^ioQ) ~ Chanaad Disk E'araaata; Blocica to 
raflact naw boots eras aathod. 



S3080-S r. 

5 30809 r. 

331205 K. 

831212 K. 



Ziotnici* (Ziiog) ■ 
aap. as Ctrl 



Addad aacapa eharaetar to iccyboard 



Graanbarg (2ilog) — ?ixad diaic paraaatar table tor hard 
driva C to point to dpbJ. not dpb2 (80 trie floppy). 

Graanbarg (Silogl — Modiliad disk paramctar tablaa for 
hard disk to looK »ore lika Sloppiaa (tawar saccora 
but aor* tractes). This Mill fix the aaetor dabloeieing 
part of tha bios ee t>» eoapacibla with boeh. Also 
switeh«d to 4K allocation blocks and 512 dirantriaa. 



'C Davica Dafmitions •/ 

•/ 
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Liating B-I. (continued} 

/* Omtitim Intmsrapt ControJLlcr conBtanta •/ 

/* Th« la«*rrupt eontrollar la an Intai 8239 L«£t-«hl£t«d on« bit */ 

/* to Allow £or cha word-Alli^nadl intarrupt vectors o£ tha ZSOOO. «/ 

/• MB AaauMtt that thia la sac up tn cha PROM •— •/ 



/* Oafina tha tMO USAJff pori:a 



/ 



/* Tha USAicra «ca Intal 3331 'a */ 



Mafina KSO 
*da£ina R3232 



OxAl 
OxCl 



tdaflna SSRDATA 
*da£in« SEBCTRX. 2 
<da£ina SEBSTAT 2 

fdafina SERXMIT 0x37 
*da£ina SERRES 0x40 
#da£lna SEHMOOE Ox£E 



*da£ina tTYOH 0x37 



#da£iRa SKimBDY 0x02 
»da£ina SEJOCROY 0x01 
*da£lna x^f 0x11 
»da£ina XOTF 0x13 



/• KaybcMurd USART baaa 
/• {is-232 tarainal 

/* data pore o££a«t 
/* control pore g££sac 
/* atatua port o££aat 



/• 


Init (3 exaaa) 


•/ 


/• 


raaat 


•/ 


/• 


aoda (2 step, «van par icy 


•/ 


/• 


parity dlaabla, S bica 


• / 


/• 


divida by 16 


•/ 


/• 


DUBIOUS. 1577 


•/ 




cad (no htint, no raaac. 


•/ 


/• 


RTS*0, arror eaaat. 


•/ 


/• 


no braak, rev cnabla. 


•/ 


/* 


DTIt"0, xac anablo 


• / 


/• 


nCV raady bit oaa* 


•/ 


/♦ 


XMT ^aady bit aaak 


•/ 


/♦ 


Control- Q 


•/ 


/* 


Control- S 


•/ 



/' 



0«£in« cha countar/ eiaar porta 



/• Tha aountar-tiaar ia «n Intal 3233 •/ 



»da£ina CT 232 0x121 
tda£ina CT^KSO 0x123 
$d*tinm CT^RTC 0x125 
»da£ina CT-CTRL 0x127 



/• coufttar/tiaar 

/• counear/tiaar I. 

/* counear/tiaar 2 — i<vt (re ciocx) 
/* countar/ eiaar concroi port 



RS232 baud raca 
— !cbd baud raea 
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rdcf.ne CTOCTi. 0x36 
»aeiine CTTlCTi. 0x76 
tact^ne CT2CTL OxB4 



Listing B-i. (continued! 



/* c/t control t>yte 
/* c/r 1 conrroi oyte 
Z' c/t 2 eoncroi byte 



•/ 
V 



control bytB is £oi.lo*»ed by USB, then MSB oi couni: co cl*t,a reoistsr '/ 
baud race c&bi« £oliows : ' •/ 



::na«: wOABCR 



:nT. i3«u(lRAC*aC iO 3 



NOT n««<i*d by the boadai Blos 



15 38, 


/• 


50 


•/ 


699, 


/" 


HO 


•/ 


256, 


/• 


300 


•/ 


12B, 


/• 


6O0 


•/ 


64, 


/« 


1200 


V 


32, 


/' 


240P 


•/ 


16 , 


/• 


4800 


•/ 


S. 


/• 


9600 


• / 


4, 


/• 


19200 


•/ 


2 


/• 


38400 


V 



*^'A<t: 



taa ConAiiiontti 



feline P&raiiei Port eonmcants 



~h« p&r&ll«l (princsr) port la *n Int:«X 8255 



i-litin* PAR_A 0x81 

♦ dfrme PAil^a 0x83 

»d»rin« PAK~C 0x85 

»d»tin« PARCTRl. 0x87 

»Qefin« PAKBSY 0x02 

§4 •tin* PASSVT 0x10 



port A d&ca 
port B data 
port C data 
eon«rel port 



bit one '.busy bit) n»«cis to b« low */ 
bit iiv ( ±«uic bit) nmm^m to b« hi^ti 
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B Sample BIOS Written in C 



Llatxxig B-1. (continued) 



PROH AMD HAROtlAiUB IKTSItrACS 



/* Omiiam PftOM I/O AddrasM* «nd RalAtad Conaeanea 



sEs aioszo.aKH fon thxsb anzwhia 



•atearn Int dlak_le< ) 7 



•xtarn ercjpucl ) ; 

•xtarn caid_boot( ) 

44la£ina OSKRXAD 

#d«£ina OSKWRITX 

«da£in« OSKfifT 

*d«fin« OSKVry 

>d«£ina OSKI^IIT 



/• (char driva. cad — di«K I/O 

/• iat bik^couBt^ 

/• Int blk^nua. 

/• char ♦daati) -> int arror? 

/• (char charactar) — put byta to CRT 

/• boot oparatinq syataa 






/• disk 


caad ccMuaand 




L 


/• dtak 


writa eeoouutd 




2 


/• di»k 


Coemat command 




2 


/• diJk 


variiy coanand 




4 


/• diak 


init . coaaand 





/* Oaflna axtarnal C/0 routinaa and 4ddr«aa«a */ 

/•••••••••.•••.••••••■^••••••'••^^•••'••••■•••♦••••••••••••••••••••"•••••••/ 

/• SEE BZOSIT'.SKll fOR THESE EXTEBOtOJi '/ 

•xtarn outpwitf ) ; /• (port, datai inej — cutput •/ 

•xtarn int input( ) ; /* (ports Int) — input •/ 

/•.,«.••...,•.•.•••••....•.••...• .,••••••.•.•.•.••.,.,..•..—..••.•/ 

/* Omtiam axtarnaX aaasry oanagaaant routinaa '/ 

' •»«•««•««•««•««««*««•«•««■•«««'•*«««*«*•••••«'•••«•••«••«****«••***«*******/ 

/• SEE SirSCAJX.afCM FOR THESE CXTERtlAi^S '/ 

•xtarn aaa^cpyO; /* (arc. daat. lan« long)— copy data "/ 

•xtarn Ion? aap_«dr( ) ; /• paddr • (Xaddr: Long: spacai vnt) •/ 

Ma etna COATA /* caXlar data spaea */ 

<»da£ina CCODE I /* caliar coda spaca */ 

*d«£ina SOATA 2 /* syataa data spaea */ 

♦dafina SCOOE 3 /* syataa coda spaca */ 

*daeina MDATA 4 /* normal data spaca */ 

*da£ina HCOOE 3 /* normal coda spaca '/ 
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Listing B-1. (continued) 

— • •"'- r «^-— — / 

.'* Svstett Entrv and St&cK Pomtar "/ 

/'•' '••' ""•' ""• ....-.,.«...••• ../ 

»<i«i..ne SYSENTRV OxOb000006L /• entry point •/ 

»ae*.ne SYSSTKPTJt OxOoOOb«£«i- /• syscca'c atac)c point«r «t4rs •/ 

■•'""•**'""'*'•"•*•"•"'"'''••*''"■''"••*'***'•••••'"'••••■•'••*•**•""•"'""■■»■""**"/ 
'* Haaorv R«gion Taoi« •/ 

/*— " --.....-.•• ., »•.. , .«.*.../ 

txtniiei UJAOCR /• NOT n««i«d for th« Loader aio» •/ 

scrur? ari I int counc; 

acruc: ilong spAiow.- 
long cp*,icn; 
I r«gionBC43; 

1 
ia«ac«b ■ i 4 , 

OxOAOOOOOOJ., OxlOOOOI.. /* owrgad I and D */ 

oxosoooooq;,. ox400ool» '" ft«parftv«d i */ 

0x08000000*., OxiOOOQ-. ' and ',' 

OxOSOOOOOO:., OxlOOOOw '* ACCVBiing I as D */' 

»enc.: " £nd condir ienft> */ 

t-.icol L^AOER .'* HECDE5 tot the l^«dar Bloo */ 

struc- art i j.nt couns ; 

long cp«lan; 
] ragionmCl]; 

i 

OxOROOOGOOI*. OxOCOOOL, /* mymtam apmcmt Mtr^ed I *ad D V 

i r ' 

snruct: concsxc /* Scarxup context Cor us«r ' 3 prograa */ 

short ra9sCl4]; 

j.on9 ••aaticpcr : 

short i^nor*; 

short rcW: 

iong PC ; 
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B Sample BIOS Written in C 



Liating B-1. (continued) 



stcuet contest eontaxt • 



tmoAit 



I 



1? 



/* Sm^is 0-13 9la«rad. sp sac up bslow 
lO, 0, 0, 0, 0, 0, 0. 0, 0. 0, 6, 0, 0, OJ, 
SYSSTXPTR, /* Lowdad «y«t««'» stack pointar 
0, /* Iqnormt valua la zaro 

Qxi)800. /* rOTi saqaantad ayataa. VX. dVZ sac 
SYSXNTBY /* BnexY point CO ayitaa 

/* End eenditionai */ 






/* Sat Exeaptlon Vaetoc antry 



astarn long trapvaoC]; 

lon^ satlrvaeti vnua* waJ.) 
int vnuaf 
Long vvaJL; 



{ 



raqlJtar long oidvai; 

oldvai • brapvacCvnua]; 
trapvacCvnua] • vvai; 

raeus'n ( oidvai } .- 



/• trap vac tor •/ 
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B Samole BIOS Written m C 



Listing B-1. (coatinued) 



' • *• *-..- « / 

•/ 

CHARACTER I/O */ 

•/ 

r.. ..,.,..«■«..«..*.«•»«......,......«»... ..•*•••••««..*.«-*«••«*../ 

— ——« — .-„-, — . — . — » — .«•• — ... — .— / 

r. ...... *.*«,....*.••.,.,.. «.,.«...«.„.,.,....«../ 

G«n«rxc S«rx*i Port I/O Procedures */ 
• .. — .-.......-«.-. ....../ 



ieJine At extern the dirty tleg. wtiich la actually defined later 
on m chia £il«. Uaad to £lush the buffer at an opportune aoaent. 



tbdirty: 



s«r ir.ic (port ) 
i.it sort; 



outautCporc-^SERCTKL, SERIHIT) 
outpuTii port*SEilCTRl., SERINIT) 
output! porfSERCTRl., SESLIKIT) 



aAUO 



••sndii 



output (port^SERCTRL, SERRSS); 
outaut(por--^SERCTRi.. SERMODE) 
output (port+SERCTHi. TTfON) ; 
) 

output! CT_CTRi., CTOCTLJ ; 
output! CT~122, baudRateaC* J) ." 
output ( C?_232.0) ; 



aeeujee the PROH aets it up. 



Conditional lor 1200 baud 
Set baud rate aenrator 
Modify for different speeds 
Set for 1200 baud 



'/ 



/* End conditional */ 



•/ 
V 
V 
•/ 



aerirdy( port 1 
Dort ; 



recurni ; ; inpuclport-^SERSTAT) i. SERRRDV) — SEJUIRUY) ? OxfF 



0) 
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Listing B-i. (continued) 



ehmz s«rin(port) 
inc port; 



whii* (••rirdY(port;) — 0) 
raeum laputt(port+SERDATA) j 



int Mrordy(port) 
iat port; 

rattunKCdnpUttport+SBRSTAT) S, SEHXRDY) — SOXROY) 7 OxfF : 0)j 
1 

s«caue(per%. ch) 
Lat port: 
eh«r dti: 

♦if BAUD /■ Condition*! Cor L200 b«ud and XOfT */ 

whil« ( ((input(port * SERSTXT) i, SERXRDY) 
l« SEiOCRDY) T ( ( ( ( input! port * SERDATA) ) 
6 Ox:?) " XOFT) — 0)); 
output! port -•■ SEHBATAt eft ) ; 



*•!«• 



-hil« ( (iftput(port ♦• SERSTAT) & SERXRDY) I- SERXRDY) 
output (porf^SER£ ATA. ch) ; 



#«ndi2 /* *^«* conditional •/ 

) 



pairordy(part) 
tnt port; 

iat statu* ; 

status ' ( input (port) ) ; 

r«tum (((statu* fc PARflSY) I- PARBSY) U 

((statu* 4 PARFLT) — PARFLT) ? OxfF : 0|r 



par out (port, cti) 
int. port; 
char ch; 

I 
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Listing B-1. (continued) 



f»qi«t.er int i. stacu«; 

■. - 0; 
do 
i 
if (—1 — 0) 



/• only check tor */ 
ipri.nt«tr (■nrPrinter Timeout, r^" ) : / * orintBr ready a */ 
return,- ■" -i^^te number of ■/ 

1 



/* tinee '/ 



while (ip*rordy(PXR B>),- /* '-'- printer reedy V 

output (port, ch): ~ /' P^mt character ^/ 

output (PWICTRL. OxOAj: / * ••t strooe lo« / 

output (PARCTW.. OxOS;i: /' ••^ atrobe high / 



Olivetti keyboard tranaiation table. .._.....' 



;r-a.- '«:3tranL 256 j ■ i 
' ^-aw <ev codei tor laain keypad: 



SOT needed for the Loader Sxoi 



. g C r F G .4 : - K 1. •-■ N 

ORSrUVWXVlOl23 



' aain keyooard UNSHirTEO. "/ 



•b'. 'c. ■&'. '•'. t' . '<3'- '^■' ■•''• ■?': '^' ; T; "',!,'. ^* 



«", 't'. '«'. 'V, w, X , y, r 



'0- , '1 • , ■2- . •2- 



■' ■ o- <?• •• •• '-• "^ • • .7.' .-, .. .1. .. • • •/• 

aair. keyboard saiFTED "/ 



0::0E, ■ : ' , 'A' , 'S' , "C" . '0' 



>. «, c. T', 'C, 'H-, ■:•. •-'. 'K', 'L'. 'M'. ■*;• 
s'' "T" ! u", 'V. 'w, 'x", 'V. ':'. '_'. '!'. ■"'. '*' 

1 , ■i','", ■;•, •)•, •-■. ■■•. ■"■. i'. ■*■• •••■ ■!■• ■'■' ■''' ■•'■ 



aa.in icev 



board COKTROL — CTL E and C diiler iro» Oliveczi. '/ 



G cAO Qjiir , 0x01 , 0x02 . 0x03 , 0x04 . 0x05 . 0x06 , 0x07 , 0x08 , 0x09 , OxOA, OxOB, OxOC. OxOD, OxOE. 

(OF ■ 0x10,0x11.0x12. 0x15. 0x14, Ox 15, Ox 16, Ox 17, Oxie, 0x19. 0xlA,OxEC,0x£l,OxS:,Ox£3. 
^ ££4 Ox££ . 0x06 . OxE7 , 0x£B,0xE9 . OiEA, OxO , 0x00 ,0x13, Oxi£ , OxlF, OxlD, Ox5E, OxFT, OxA4 . 
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Listing B-l. (continued) 

/• amia Kayboud COMMAtlD •/ 

QxDW OxW.OxeO. 0x81. 0x82. 0*83, 0x84. 0x85, 0x86, 0x87, 0x88. 0x89. OxaA.OxSB.Qxac.OxSD. 
JSeIoxS 0X90 oSr.Ox92. 0x93.0x94. 0x95. Ox««.Ox-97.0x9a.Ox99.0xJC.Oxra.Oxa.O^^ 
oSo! oSl . OxJfs! 0xJf3 . 0XF4 . 0x#5 . 0xir6 . 0XT7 , 0xi3 , OxiC. OxFC. OxFO. 0x9F, Oxf9 , OxFA. 0XA5 , 

/' 



o«h«r k«ya 








KCTPXO 

2 
S 


cat 


3 
7 


31 
00 

4 

8 

« 


32 
L 
S 

9 

/ 



/• oeii«r 5c«f« UMSHUTED — ca differ* «ro« Olivetti •/ 



r*. 0x7 «, 0x08. 
'0',0xA6, 'I'. 
•3', '*'. '5*, 
•7', '8', '9', 
■-'. ••'. '/', 



/• other kmy* SHITTED — CR diffwrx tzom Olivetti •/ 

• ' . 'c* ;0xAa,0xA9, 

•.', "O* .0xA6,0xiC. 
0x9A. 0x10 . 0x98 , 0x9C . 
Ox90.0xl£.Ox9E.OxiF, 
0x2B. 0x20. 0x2A,0x2Jr. 

/• other iteye COMTSOL •/ 

' ' , 'r' ,0xAa,0xA9. 
0x80,0x81.0x82,0x83. 
0x84.0x85.0x86.0x18. 
0x88.0x89.0x8^.0x88. 
0x8C. 0x80. OxBK. 0x8? . 

/• special — »ub«tittuce c Coir Olivettx's OxAF. */ 

' ff • , ' c ' , ' r ' , • c ' 

1; 

♦end if /* ^"'^ condition*! •/ 
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Listing B-1. (continued) 

soeciiic I/O orocBdurwa for u>« with lobyte '/ 

• CRT scacus, rtt*d. write roucinaa '/ 

.n- cr-ri ( ) 

returnC »erirdy( KBD) ) .- 

»i:ndef I-OAXIER / * '^'^ n»«d«d tor the U>*d«r Biot "/ 

-har cr::rd( ) 

r«t:urn( icberanC »«rin{ KBD) k Orif]): 

imic.-.i '" ^d condailon^ki */ 

*•, *Q«f UJACER /■• Condizionni tar U»*d« Bio* di»»tJi* KfiD '/ 

*Q*t-^n9 crrrd nulrd 



* End condttionfti *.' 



..-1 -rtws I . 

re turn I OxFT ) : 

*dezine crtwr crx_^ut /* output routine in PROi •/ 

* ""TY st&cut, r«ad. write routinae "/ 
xnz ttyrsC ) 

return( ••rxrdyi RS232 ) ) r 

•::har ::-yrd{ ) 

recurnt •«rin( RS232 ) ) ; 

returnC ••rordy ( RS232 > ) : 
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Uia'tinq B-1. (continued) 

char chf 
{ 

■•reue(RS232, ch); 
} 

/* LPT «tatua> output rautlQ«a */ 

int lptw«( } 
I 

ratum (pavordy (PMl^B))r 

lptwr<ch) /• AA08U3X0 •/ 

char eh; 

I 

parout (PAR \. (A)} 
) 

/••••*««.«.•«•••.«•*»««•«•,.*••««•••••***••«*«*••«•••••••.*«•*•*•«*....../ 

/* gvnaric dwvtc* nanaat batxh, and null d«vic«« */ 

/«•.,•..,«„»«.««•••••.•,««•••««»«••••••*••«,•«•,.•„...,.••.•.«*...*..,./ 

/* th« davica ammmn <ira ttm ottMttt. oC ttm pcopar fiaJld ia iobyta */ 

*dafina COti 

tdatina RfiAOSSt 2 

Mafina PUUCU 4 

#da£ina LLSf 6 

/* iKTCB statua. eaad, writa coueinaa */ 

*i£ndaC UMOER /'XT naadad lay eha Coactar aioa *'' 

int batrai ) 

( 

Int ganataei ) ; 

ratum ^anatatiltKAIMER} ,* 

} 

char bated ( ) 
I 

Lnt <|anr«a<l( ) ; 

caturn gantaadt RCAOSR) ; 
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Listing B-1. (continued) 

chAZ ch; 

ganwriceC 1.1ST, eh ) : 

♦ enttii /• End Condit iori»i */ 

fiiaaJ U3AOER /' NEEDEC ior the Loader Bio« •/ 

f Of tine bacrd nuird 

» define oacrs nulBt 

»d,stine batwr nuiwr 

»«ndii /• End condicxonAJ. •/ 

/* tfQLL acACUs. r»ad, writ* roucinas */ 

caturn OxFF: 

c:n«r nulrd( > 

return OxrF: 

auiwri::h.. '* ARCSUSEO */ 

-rar en: 



Generic Z/0 roucinea usmt} lo&ry'i* */ 



»• robyte itseif. 

=r.ar lobyte ■ 0x41 r : 

'" Oevice opar&tiOR T:&ioIa«. 3EV1HDEX la the ;ndex inco ch« 

•" t-aaie appropnac* to a device I row) and its lOOyce indas (coiuan) 

*"' nonexistent devices are mapped into tTUI.. 

».let:i.n« OEVINDEX ( ( ( iobyte> >dev ) fc 3) * (dev " 2) ) 
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Listing B-1. (continued) 

tnt (•■«&!£ 161) () "I ,^ ,, 

etyrn, crtra. toatra, twiiati, /* con / 

ttyrsj auiat, rmiat, rtulatt, /* r«ad,«r •/ 

ttyws. rmiat. nuiat, nuiatt, /* punch */ 

ttywa, crtwa, Lptwa, nulaiB /* iiat •/ 
J» 

char (•rdtblCl6])() • I 

ttyrd, crtrd. batrd, nuird, 

ttyrd. nuird. nuird. nuird. 

nuird. nuird. nuird. nuird. 

nuird. nuird. nuird. nuird 
); 

int ( •wttoiC 1« 1 ) ( ) - t 

tty%rr. crtwc. b«ewr. nuiwr, 

nuiwr. nuiwr. nuiwr, nuiwt« 

ctywr. nuiwc. nuiwr, nuiwr. 

ttywr. crtwr. Iptwr, nuiwr 
); 

/• 

** tih« ganarie aarviea coucinaa chasaaivaa 

V 

in'C g«naea&(dav) 

inc dav; 

[ 

raeurnt CsecbiCDCVUloexj) () ): 

J 

int. ganra«d(dav) 

inc davr 

I 

cacurn( ( TdtbiC DEVIMOEXJ ) ( ) ) ; 
I 

9anwri«a<dav, ch) 
int dav: 

char ch; 
I 

( •wcthiC DEVIMOEX J ) ( ch ) : 
1 

♦ ifndaC U3A0£R /* ^T naadad Cor UMdar 3ioa "' 
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Listing B-i . (continued) 

- • • / 

'* -rror procedure tor 3I0S "/ 

'Qxa««rr i mvmmq ) 

re<j later ch*r '«rrm»g: 

print«tr( "nrSlOS ERAOR — " ) .• 
prmcacr ( ecrasg ) : 
princ*cr( " .nr " ) ; 
whiXcd); 

printBcrts) /' uMid by &xoB«rr '/ 

ragxster ch«r 'a; 

t 

while ("s) lcrtwr("»); « r« 1 ; 1 ■■ 

»«r,cii; /' End conditional '/ 

»i:afti 3EBUG ' * Coniicion*! tor DisR D«Dug9in<g Hax ouepu: '/ 

pu;:.n£xa{-.; '* put a hex diqii io crt ' • 

. i.- Qxt: 
•.t (1 ' 10) 

crrwrt i * '0 ' ) r 
else 

crcwr ( I * ' » ' - 10 ) : 

pu^hexvii) /• 'put' an int in h«x •/ 

I. n : 1 ; 

puch«xd{ 1 >» 12); 

puih«xd(i >> 8); 

puth«xd{i >> A): 
pus^«xd( i ) ; 

»encil '" Snd CQnditionai •/ 
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B Sample BIOS Written in G 



Listing 3-1. (continued) 

fz-^.-:^:::— ------ —v=:^-^ 

/* DISK 1/0 •/ 

^ ...................^. ;; 

/♦•••...^..•.••.•.••♦•.^...•.••..♦.♦••••.•..,^.,.,..,,,.,*....„.,.,.,,,^ 

/• BIOS tatolm Oaflnition* •/ 

•truet dpb 

Int apti /• sacrcors p«r track •/ 

ctmx b«h: /• aiocK shift ■ Loq2(ble>cJt»ii«/l2a) •/ 

ch»r blBf /• block aasK « Z**b«h - L •/ 

ch«r sxat /« axtant iuk«K •/ 

ch«r dpbjuaK: /* duauiy £i«id to aiiign wprd« */ 

Ine d«a7 /* six* a£ disk Lass otismz, in blocks */ 

tnt djraj /• ai2« o« direccory - I '/ 

ch«r aiO; /• rssarvacion Dita fior directory •/ 

ch»r *ii; /• ... •/ 

inc ck«» ■ /* 9izm ot chceksuH v#ctor ■ (dr»*L)/4 */ 

int oti: /* track o£f»«t «ot OS boot •/ 

«h«r pahr /♦ Loq2( ««etor»iz«/iaa) •/ 

ch«r . pamt /* phyaical slz« lusk - 2*«piih - t */ 



««ruet dt>h 






ch«r 


•xltpr 


..A / 


inc 


dpAaer£3]; 


/ 


ch«c 


•dirbufpT 


/ 


scruec dpb 


"dpbpi 


/ 


char 


"cavpr 


/ 


char 


•aivpi 


/ 



"> ««ot:or tranaiation tatol* ■/ 

scraecttpad Scar aOOS .*/ 

-> dixactory buffer (128 sytaa) •/ 

•> diak paraaatar block */ 

-» seftMtrs chack w«ctor (ck* bytas) •/ 
-> alloc vaecor ((daa/QJ^l byta«> •/ 
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I^isting B-1 . (continued) 

••"" " «•. — --..-.-.-,...•.. n,... / 

" Oi«k Pa.r&ii«cer BlocKs •/ 

" -.- — «w ../ 

" CP/K assumes chat disks ar* nade of I2S-byta Io9ical s«cror>. 

" The Oiiv«tti us«8 25fr-byt» sectors on its disks. This SIOS buffars 
*"* a oracle at a ci«e. so swccor addrass cransi.ac.ion is not naaded. 

"' Saapia t&blaa are incXudad £or ••vara! difierant disk sizas. 

/ ' ... Qlivatti has 3 floppy formats fa a hard disk — • •/ 

»fle£ina SECS2 128 /* CP/M logical sactor sisa •/ 

»d«iina 7RKSZ 32 /• track size for fioppias, 1/2 track sz for hd •/ 

»oefin« PSECS2 256 /' Olivatti physical sactor sisa •/ 

♦4Bfin« PTRXSS 16 ,"• ohysical trsck siz« "/ 

«.;ndBf TKMSFZn /• Conditional for Normal bios •/ 

* a«ji. numomr of disks */* 

* End conditional •/ 

* Tranter Conditional needs an extra dpb define*'' 

* Disk 4 is a pseudonya lor disk *, with •/ 

* an old'Stylt dpD to rescue those flies. */ 

* End conditional " / 



»<>cfine MMQSK I 

♦ ■•mdii 

«ifd«f TRANSFER 

*.lefine .MAXDSK 

»sr.dif 



' """* sot, nmh, bis. exB. jnn. dsm, drm, alO. all. ckm, o££, psh. pmm */ 

J cruet dpb dpbO- /* - — 1 side, 16*256 sector, 35 track. 140Veb — ■ •/ 

i 32, A. IS. 1, 0. 64. 63. OxCD, 0, 16, 3}; 

struct dpb dpbl- /• — 2 aide. IS'Sifi sector, 35 track. 2aOkb */ 

I 32. 4, IS. 1, 0. 134, 63, OxCO, C, 16, 3l: 

struct dpb dpb2" /" — 2 side, 16*256 sector. 80 track. 640kb — •/ 

i 32, 4, IS, 0, 0, 314, 63, OzCO , 0, 16, 3]:. 

struct dpb dpb3« /• 6 side. 32''256 sector. 180 trk. 8640kb — — "/ 

i 32. 5. 31. 1, 0, 2154, SLi, OxtO , 0, 0. 3 } : 

tiid'ef TRAMSrSR /' Conditional Tranfar dpb d*£in«d here •/ 

struct dpb dpto-*» /• — 2 side, 16'2S6 sector, 35 track. 2aOkb •/ 

I 32, 4, 15, 1, 0, 120, 63, OxCO, 0. 16, 10); 

♦endif /* End conditional •/ 

bis ■ 2K dsa " (disk size - .3 reserved cracks) ,■' ol» '/ 

Dls ■ 4K for hard disk (8640 - 24) 4 «,• 

n:dei SEcr26 /" Conditional for 8" floppy drives •/ 

,- >«•■ -^^ Olivetti does not tiMve 26-sector disks, but many people do. 
'" The followmo parameter blocks ars provided for their use. 
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Listing 3-1. (continued) 



struct dpb dptoS* 

( 26, 3, 

fltruot dpb <^bO«* 
I S2, 4, 

ieadlf 



/* — • 1 Sid*. 26 •128 ••ctor, 77 txk 

7, 0, 0. 242, 63, OxCO, 0, 16, 

/• i 3id«. 26«2S6 »«ctor, 77 trie 

IS, 0, 0, 242, 63, OxCO, 0, 16, 



/* Bad eoindltxoaaX */ 



2} 



/* BDOS Scratehpttd Araaa 

^wr dicbufC3XCSZ3; 



.«$. 



ehac esvOC 16 ] ; 
char esvlClB]; 
char esv2C32]; 
$itAmt TRMIS7SR 

Char esv3Ci6]; 
•«ndi£ 



/• For Tjr*n«<«r conditional •/ 
/* End conditional •/ 



char «lvPC32l; 

char «lvl02}; 

char Alv 21:2002 3 ; 

9i£d«t THANSrER 
char »iv3C32]; 

««ndl£ 



/• (dsaO / a> ♦ 1 


V 


/• (d«al / a) * I 


V 


/* (dM2 / 8) ■» 1 


•/ 



/• For Transfar ctasditionai •/ 
/• find conditional •/ 



/* Saetor Tranalata Tabla 



4ki£d«< 3CCn6 

char 



/* Conditimial £or 8" floppy drivaa */ 

Tha Olivatti doaa not hava 26>«aeter diaks, but aany paepla do. 
Tha eollowltt9 trviaXata cahla is providad £or chair u««. 



xlt26€2&3 - ( 



L. 
2, 



7, la. 19, 23, 

8, U, 20, 26. 



5, 11, 1,7, 23, 

6, 12, 18, 24, 



3, 9, IS, 21. 

4, 10. 16. 22 



»andi£ 

char 



/• Snd conditional •/ 



xitl6C323 " I l, 2, 3, 4, 5. 6. 7, 3. 9,10.11.12,13,14.13,16, 
L7 , 18 . 19 , 20 . 21 . 22 . 23 , 24 . 25 , 26 , 27 , 28 , i9 , 30 , 31 , J2 ) ; 
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I-isting B-1. (continued) 



Disk Paraaecer H««d*rs 

Three diatcs &r« d«£xntte: dak 

dBk 



disteno-O, 

distcno"!. 



drive 
drive 1 
drive 10 



»itncie£ TRANSFER 
struct dph dphc«bC3] 
t (xlU6, 10, 
Iritie, 10. 
ixitl6.- 10, 
); 
«and:.f 



/" Normal bio« dph conditional •/ 



0, Oh di,rDu£, bdpbl, 

0. 01. dirbuf. bdpbl, 
0. 01, dirbui, bdpb3, 



csvO, &lvO] . 
CBvl, aivl I , 
csv2, &1.V2] , 



/* End conditional "/ 



/•d«K a'/ 
/"d»K bV 
/•da>? c*/ 



♦iidef TRAKSFSR 




,'"• Trnaler conditional with extra 


dph •/ 




st;ruct dph dph6*b[4] 


■ 








1 ixlU6, iO, 


0. 


01, dirbui. adpbX, esvO, <tlv0}. 


/•dan 


• •/ 


ixlsl6, iO, 


0, 


01. dirbuf, (idpbl, csvl, 4lvij, 


/"dan 


b'/ 


ixlri6. lO, 


0. 


Oj. dirbu£, bdpbJ, Cflv2, «lv2}. 


/•dak 


c*/ 


■:xiti6, iC. 


0, 


0], dirbul, fcdpb4. c»v3, »lv3J. 


.'•dak 


a-' 


» end if 




/* Snd conditional •/ 







Currently Selected DiaK Stuii 



-iz sectrkc. a«ta«c, setdaK: 
orxj s«cdMa: 



/• track, sector, disk » 

/* dma addreaa with seoment into: long 



nar 


trKbufCTRKSZ 


nt. 


tbvaiid - 0; 


nt 


cbdirty ■ 0; 


r.t 


tbtrk; 


nt 


tbdaitr 


nt 


dstcerr ; 



SECSZ): /• tracic bultet •/ 

/• traex buJfer valid •/ 

/■' traex buflar dirty •/ 

/• track buSfer tracit « •/ 

'■• track bufter diak f •/ 

/• diak error */ 
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Listing B-I. (cfsntinusd) 

/• Oiak I/O ?rac«duc*« •/ 



dmtattmridmk. trie, buffi, cad) /'* tstumtmt « di«ic tzmek */ 

r<B9iatar int dak, trk, emit 
r«9i«t«r ctimx *bu£p> 

Thia 1« « handy piaca eo kaap noeaa on Olivaeei block 
nuatoaffiag. for a floppy, bits 3<-0 «ra saetor. bit 4 i« aida. 
and hi9li<-ordar bica ara tirack. Vfa daflna a floppy to hava 
twiea aa aany sac«oea «a thaca ara oa a track; thua. tha 
aaceor miabar ovarflowa to tha axda bit and all ia wall. Oa 
tlta hard di«k« bica a-O ara aaecor ( thara ara 32 par track), 
and tha high-^rdar bita ara ( track *(i)'^aurfaca. whara surface 
ia in tha raflga 0..S. To saka tha indaxinq of crkbuf conaiacant. 
wa dafina a hard dlak to hava only 32 logical (16 physical) 
saetora par track, lika a Cloppy. Thua v*a will tranafar only 
half a track to/froa tha buffar at a tiaa. and cha logical 
aaeror nuausar w^ill ovarfloM into tha raal high-ordar bit of 
tha saetor nuiaOar. Thia werka bacauaa va wi.il always aov« 
half a track at a tima. Tha tracks and surfacaa siaply taka 
cara of thaoaalvaa, incrasanting through tha surfacaa and 
affaceivaly ainiaixlng saaks. 



ctsnvart hard dlak driva « */ 

Conditional raaaignaane for Tranafar */ 

for tranafar diaka */ 

End conditional */ 

aaausM no arror */ 

do tranafar */ 

Conditional OEBUQ output */ 

biknu« - trk'FTWCIZ; 

pr3.ntatr( "nxf ar block '); 

puthaxv<blknua) : 

printatrl" unit ■')r 

puehaadCdak) r 

printaert " track "); 

puthaxv(crk) ; 

if (cad >- OSKRSAO) 

princser< " raad" ) ; 



•/ 

{ 


ine blknuisr 
if (dak— 2) 






dak « 10: 


/ 


»ifdaf 


TRAMSPES 


/ 




if (dak— 3) dak • Lj 


/ 


*«ndlf 




/ 




dakarr*0 r 


/ 
/ 


nfdaf 


OSSUG 


/ 
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Listing B-1. (continued) 

e ise 

printstr( " write').- 
cr^wr (10 i : crtwrdi) ; 
♦ encii ," End condi::ionai */ 

If (0 I- cli»K_io(<i»it, end, PTRKSl, tric'PTRKSZ. »4p_ftdr ( ( long)l>utp, ) ) ! 

dsnerr-l; ~ 



»de;in« -ronijtk ((1 cbvaiid) || ( tbtrk I- mettrK) I! ( sbdalc i« aatdakt) 
• derm* qectrk if (wrongtk) tilitb( ) 

*'.tnd«£ LOADER /* HOT n*«d«d tor Lo«d«{ Bion */ 

ilu3n( ) 
i 

.i ! tbdirty i.t. tbvalid ) dskxfcr ( cb<ask:. cbcrk. zs<aMt. OSKWRZTE): 

lodirty ■ Q: 



" tna condiiionai *- 



_-.io( 



»i:nd«£ -OADSR '* NOT n**d«d by i-oadet Bio» */ 

if , tbvaiid (ib sbdirty ) ^flu«h{); 
*endif /*' End eondi;:xon4l •/ 

dsKxt«rt s«cds)i. s«ccr)i, :r)cbu2. OSKRCAD;; 

tbv»iid ■ 1 ; 

-bdirty ■ 0: 

-btrlK ■ »«crr>t; 

ibdsk * sacdsk; 



la.cread i ) 

registar char 'p; 



g«ct:r)c; 

? - ttrkbuftSECSZ • (s«ta*c-l)3. 
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Listing B-I. (continued) 

/* tr&a«far b«tw««n B«aery sp«e««. satdaa Ic physicai. «ddraaa */ 

aaa_^qpy(a«p_,ad.rnioD9)p, CDATK), s«tdB«« ( ion? ) SECSZ ) ; 

r««urn( dafcarr ) r 
) 

*lfad«f U3A0BR /* lilOT n««d*4 by Loidmt Sios it doaan't writa */ 

dakwr i ta < aoda ) 
char aoda; 
( 

rag is tar shar *pr 

9«tiuf ic ; 

p <• SiCrkbufCSECSZ • (sata«e-L}2; 

/* C9ana£ac baewaan aumory spaeaa. «atdma is phyaical addrasa '/ 

ma»_cpy ( satdaa . aap «dr ( ( ion? } p , CDATA ) , ( lonq ) 5ECSZ ) : 
tbdirty ■ L; "" 

if ( apda -• I ) tXamhl ) ; 
raeuvntdakarr) ; 
1 

««ndif /* Snd condicionai */ 

char saetran<«. xp) 

int *t 

ohar "*pi 

I 

1£ (xp i« 0) caturn xpCs]; aiaa raeucn s; 

««ruet dph *8aidiatc(dai(, ioggad) 
raqiacar cbar dale; 
char loggad ; 

ragiatar aerucc dph *dphp; 

if (dsk > MAXOSX) racurn(OL); 

aa«datc « dsK; 

dphp * &dphea.bCdi«k]; 

if (dphp >- dphca© *> (aixaof (dpheab) /sxsaof (scruce Jph)) ) raturn(OI.i; 

if ( 1 Loggad ) 



disk noe Loggad i.n. tiaiaec dansiey, «cc. >»■ */ 



) 
ratucn(dphp) ; 
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Listing B-i. (continued) 

BIOS PROPER */ 

r ' 



DlQSirtlt ( ) 

»itd«£ DEBUG /• Condi rionAi S»*nn«r tor DEBUG '/ 

princ»tr( "rnCP/M-eooO: 01iv«tti M20 BIOS DEBUG" ) .- 

♦ endil '• End condi^xonai ',' 

"* »«rinit( KSD) : *, '* DOK'T init ^•yC>o«rd lerxAi port 

9c;3.nic( RS232 ) ; '* imi ;s2J2 s«ciAi port 

:3w»iid ■ 0; '* inn di»K il«g» 

iixiirty « 0: 

'* Foiiowing res*- si looyt* on •aci*. wane t>ooi h«» &««r. 
" removed. «c tnai STA.T can reassian aevices. iooyt.* 
'* IS now mi^id.^zed or sois oooc only. 
" lobyce ■ Ox4i,- '/ — cor., li»t » CRT rdr. punch • TTY 

• 1.-- the UiACER aio». the n&in routine is called "bios", not "^bioi" */ 
«■. idef LOADER /• Loader Sioe conditional */ " 

*define _!9ioa bioa 
»endif /" End condition&l "/ 

konc biosldO, dl. d21 
^r.t ~ dOr 
i.anq dl, d2; 

switch(d01 

case 0: " INIT* 

oxosinit ! } - 
Isreax ; 

« 

• ■. indef LOADER /' Normai 3io« use • '' 

ca«e 1: ," W800T 

wboot I ) ; 
break r 

»"»ndif /* End conditional */ 
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B Sample BIOS Written in C 



Liating 3-1. ( coatinued ) 



titttOmt UMOSR 



CAM 2 J /• COMST 

br««k ; 

emM 3 1 •/• COKM 

tmtuxnlqmarmmidiCOU) ) ; 
braak r ;^ 

CAM 4( /* CQHDUT 

9«iwrie*<(:oii. (char}dl); 

I* Monuil Bioa a** */ 

ca0« St /* I4XST 

9«Rwcit*(JUXST, (ch«r)dl]r 
braak ; 



61 /* PUNCH 

•lanwr 1 ca < PUHCU. ( char } dl ) ; 
bcaak ; 



•/ 



caaa 7: /• READER 

r«turn(9aiuraad(IUBA0ER) ) ; 
braak: 



V 



*«ndi< 



eaaa 8* 



/• HOME 



braak; 

/* Cad eonditionaX */ 



caaa 9t /• SSZ.OSK 

ra«um(( Ion4)fl«idlak((ciMur)di. (char)d3)) 
braak ; 



eaaa LOt 



saetrk « ( lae)dl; 
braak; 



/• SETTRK 



caaa Lit 



«aeaae » ( iar)di; 
braak; 



/• SETSEC 



caaa L2x 



■atdaa ■ di; 
braak ; 



caaa 13 > 



racurn(dskraad( ) ) 
braak; 



/• SETI»IA. 



/• READ 



'/ 



B-2S 



'S M-300C Svstem Guide 



Samale BIOS Wri-ten i: 



f.lndef -0AJ3ER 



♦ end 1 i 



Listing B— I. (continued) 

/* Normal Bios use '/ 
c&ae i4: '• WRITE 

return(d«>cwrite{ (char )dl ) ) ; 
tsraaK ; 

caa« 15: /• -ISTST 

r9Curn(i3«nsuc( L2.ST)} ; 
tiraak; 

/• End conditiorvAi '.' 

eas« 16: /* SSCTRAK 

r«curn( •eccrani ( mOdi . 1 char*)d2 ) } 
br«*ic r 



cas« 18: 

recurn ( ( long )faB«jBCAb> 
braAk : 

<i:nda£ LOADER <" Normal Sxos u«« *^ 

aaa* 1 9 : 

rtturr( { long ; to6yt« i ; 
9r*aK : 



=&•• 20: 



lOByt* « (cnar)di 
ars*x : 



=«•• 21 : 



/• QMRTA 



C£7I06 



'• SET108 



/• rtUSH 



* end if 



£Iuah( ) ; 

r«curn( ( long )dsk:«rr I : 

b raslc ; 

/* End eonditionftl */ 



CB*« 22 i 



/' srrxvEcr 



r«eurn( ■«cxv«ec( ( ini;)dX. 42]) 
brcaX.- 



.' * and switch "/' 
!ret.urn<0) ; 
' iind BIOS procedure " / 

£nd of C B\Q% ' / 



'/ 



'/ 
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B Sample BIOS Written in C 



Listijig B-2. formal BIOS Aaaeabler 



; Build th« a38«mbly nodules using conditionals 

fxti .s«ct 

;by setting th« value of the label LOADER false 
;(0) the normal Bios code will be generated 
r^^ile setting the label to true (1) will 
; provide the loader Bios code. 

I ; ]. or which ever 



LOADER 

• 
f 


.equ 


9 


. input 




.input 




. input 




.input 




. input 




. input 




. input 



"biosdefs.akn" 

"bioaboot.Skn" 

"biosif.akn" 

"bioaio.Bkn" 

"biosmem.Skn" 

"bioatrap.Skn" 

"syacall.akn" 



* 

* Data 



bssi 

^sysseg : 
2|usraeg: 
[^syaatk: 



>sect 

.block 2 
.block 2 
.block 4 
.block 4 



,* system segment 

;user segment 

; system stack pointer 

; program status area ptr 
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Listing B-3. (continued) 

* Trap vect.or table 

* entries 0..31 are misc. system traps 
entries 32.. 47 are svstem calls . . 15 



■.rapvec: 

.block N'TRAFS*4 



8/15/84 R.r.W, 
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B Sample BIOS Written in C 



Lifting B~4. BIOS Asseably Language Definitions 



b i osde f s . 3kn cp n . sy s -^cpmldr .ays' 



Assembly language definitions for 
CP/M-aOOO (ta) BIOS 



* 821013 S. Savitzky (Zilqicr) — created. 

* 



* System Calls and Trap Indexes 

* 



XFER__SC .equ 1 

S10S~SC . aqu 3 

aDOS""SC . equ 2 

MEM Sc .equ 1 

DEBUG^SC .equ 

;* the traps use numbers similar to those in the 

?* SBK version of P-CP/M 



SITRAPS . equ 48 
SCOTRAP .equ 32 



EPUTRAP .equ I 

SEGTRAP ,equ _, 2 

SMITRAP .equ 

PITRAP .equ S 

TRACSTR .equ 9 



; total number of traps 
rtrap * of system call 

ZSOOO traps 

;EPU (floating pt. emulator) 

/segmentation { 68K bus err) 

; non-maskable int . 

;priviladge violation 
'Interrupts, etc. 

; trace 
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Liscing B— 4 



(continued! 



Z ScacX frame equates 

A C stack frame consists of the PC on top. 
followec by -he arguments, icftciost argument first. 

The caller ad:3usts the stack on return. 
Returned value is m r? (mt) or rrS (long) 



PCSI2E 


. equ 


2 


INT SIZE 


. eou 


2 


LQNGSISE 


.equ 


4 : 


ARGl 


- equ 


PCSIZE 


nJiZ2 


. equ 


AJRGi-rlKTSIZE 


.\^C2 


. ecu 


ARG2^INTSIZE 


AJlG-i 


. ecu 


AilG JOINTS I Z£ 


kRCz 


. eau 


AJ^G4^INTSIZ£ 



PC Size non-3egfflentad 
INT data type size 
LONG data type size 

inteaer arauments 



Segmented Mode Operations 

NOTE: segmented indirect -register operation* 
can be done by addressing the low half 

of the register pair. 



SEC 



MACRO 



START segmented aode 
rO de St roved. 



idctl 


rO,FCW 


set 


rO,#15 


Idctl 


FCW, rO 



.ENDM 



NONSEG . MACRO 



Idctl 
res 

Idctl 

.ENDM 



rO,FCW 
r0,#15 
FCW, rO 



END segmented mode 
rO destroyed. 
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scaXX .MiVCRO 



sscalX . MAC50 



hiatxnq B-4. (continued) 



; ( segaddr } 



segmented CALL 



. word OSFOOh 
.long ?1 



; ( I segaddr I ) 



short segmented CALL 



. word OSFOOh 
.word ?l 

.£NDM 



* 
• 
* 

*4 


System 


Call 


Trap 


aandlsr 

IP*******! 


Stack 


Frame 



crO 


.equ 





•WORD 


caller 


rO 


crl 


«egu 


crO+2 


>HORD 


caller 


rl 


cr2 


• equ 


crl+2 


■WORD 


caller 


r2 


cr3 


.equ 


cr2+2 


•MORD 


caller 


r3 


cr4 


.equ 


cr3+2 


•WORD 


caller 


r4 


crS 


.equ 


cr4+2 


■WORD 


caller 


rS 


Gr6 


.equ 


crS+2 


•WORD 


caller 


c6 


cr7 


.equ 


cr6+2 


■WORD 


caller 


r7 


crS • 


.equ 


cr7*2 • 


•WORD 


caller 


r9 


cr9 


.equ 


cr8f2 


■WORD 


caller 


r9 


criO 


.equ 


cr9+2 


•WORD 


caller 


riO 


crli 


.equ 


crlO+2 


-WORD 


caller 


ell 


crl2 


.equ 


cril-f2 


•WORD 


caller 


ri2 


Grl3 


.equ 


cri2+2 


WORD 


caller 


rl3 


nri4 


.equ 


criJ+2 


WORD 


normal 


ri4 


nrlS 


.equ 


nrl4+2 ; 


WORD 


normal 


rlS 


scinst 


.equ 


iiri5H-2 


WORD 


SC instruction 


3c£cw 


.equ 


scinat+2 


WORD 


caller 


FCW 


scaeg 


.equ 


3CfCW+'2 


WORD 


caller 


PC SEC 


3CpC 


.equ 


scseg-f2 


WORD 


caller 


PC OFFSET 


FRAMESZ 


.equ 


scpc'+'2 
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Listing B-5. Olivetti Bootstrap Initia-Iixation 

*■***■"*** biosboot. 81cn for cpni.sys ■* cpmidr . sys***** 

* Copyright 1984, Digital Research Inc. 

* 821013 S. Savitzky (Ziiog) — adapt for nonseg . 
' 320930 S, Savitzky (Ziiog) — created 

' B40813 R. Weiser ( DRI ) — conditional assembly 



. sect 



* NOTE — THIS CODE IS HIGHLY SYSTEM-DEPENDENT 

This aodule contains both the bootstrap 

* writer, and the code that receives control 

* after being booted, 

* The main function of the latter is to make 
' sure that the system, whose entry point is 

called "bios", is passed a valid stack 
and PSA pointer. 

* Although this code runs segmented, it muse 
be linked with non-segmented code, so it 

* looks rather odd. 
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Li«ti»g B-5. (continued) 



* CP/M - 8000 on th« Olivetti ^^20. 



OIlv«ttl's peculiar formats has a Ion o£ 
Olivetti's file systea in it. 

Track ia unuaed except for sector 0, since 
it is single density and thus has smaller 

sectors. 

A. total of 10 tracks are reserved from C?/H, 
leaving 9 tracks for the system proper. 

The first sector on track 1 Is the PCOS file 
descriptor block? the second is the boot file 
header and the start of the system code. 

This leaves something under 28K for the 
system ( BIOS+BDOS-KZCP ) . It is assumed that 
the system starts at its lowest address, 
and that data follows immediately after code. 

For, now, we assume that the systam starts at 
<<!!>> 0000 (hex) for normal system 
<<10>>0000 (hex) for boot systam 



Globals 



. if LOADER 

.global ^startld- ; entry to read systam tracks 

•endif 
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Listing B-5. (continued) 



Externals 



Global bios 
I t LOADER 
. else 

global _wboot 
.end if 



; no warm boots xn loader bios 



Constants 



LOADER 



30GTSYS 


-eau 


OAOOOOOOh ; 


300TSTK 


. equ 

.else 


BOOTSYS+OBFFEh 


SYSTEM 


. equ' 


OBOOOOOOh 


SYSSTK 


. equ 
. end i f 


SYSTEM-fOBFFEh 


3PT 


• ««IW 


16 


3 PS 


. equ 


256 : 


NBLKS 


. equ 


9-16 


HDRSIZE 


.equ 


24 : 


rILSIZE 


. eou 


256*{NBLKS-i ) 


SYS3I2E 


. eou 


FILSI2E-HDRSIZE : 


31SIZE 


.ecu 


, 3PS-HDRS:ZE 


S£G4 


. eou 


04000000h 


S£C;2 


. equ 


02000000h 


SYS PSA 


. equ 


SEG2^100h 


aOQTPSA 


. equ 


SEG4+100h 


3 s call 


. oacro 


; short se 




.word 


OSfOOh 




.word 


?1 




. endzD 





system address on boot 
system stacK top on boot 

systea address 
systen stack top 



irblocics in a track 
tbytes in a sector 
fblocks in boot 
kbytes in header 
file data size 
total system sis*' 
data in sector 1 



system PSA 

PSA in PROM for boot 
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Listing B-5. (continued) ^^ 



* Entry Points «md post-boot Initialization 



;* trans far vector 

.i-£ LOAOSR 

.«ls« 

jr v^boot 

.•ndi£ 

jr entry 

;• post-boot init. 

entry s 

. if LOADER 
_^startld: 
"" .endif 



; aio %nirm boot in the loader bios 



•SEGMENTED 



01 



Vl.filVI 



. i£ LOADER 

Ldl rrl4, fBOOTSTK ;init boot stack pointer 



.else 

Ldl 

.endif 

ldl 

Ldctl 

Idctl 

Id 

Idir 

Ldl 

Ldctl 

Ldctl 



rrL4, #SYSSTK 

rr2, fSYSPSA 
r4< psapseg 
c5, psapoff 
rO, *S70/2 
9x2, <ixA, tO 

t:v2. fSYSPSA 
paapsegr ?2 

psapoff, r3 



init normat stacX pointer 
copy PROM'S PSA 



shift PSA pointer 
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Listing B-5. (continued) 



Id r2,#142h 
id r3, #lf eh 
out @r2 , r3 



Idar 

id 

DP 



r2, S 
r3 , f bios 
@r2 



CROCK — turn off 
' usart interruDts 



QO 



. X f LOADER 

.else 



;no warmboon in loader bios 



wboot. : Idar 
id 



r2, S 

r 3 , #_wboot 

.end if 
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Listing 3-6. BIOS Ansetably Language Interface «, 



'** bioai£*akn for cpm.ays + cpmidr.sya ******* 
Copyright 1984, Digital Rea«arch Inc. 



* Aasenbly language interface for CF/M-8000( tat) BIOS 

* — — Sya tea- Independent — — 



* 



• 321013 S. Savitzlcy (Ziiog) — aplit into moduiea 

• 820913 S, Savitzky (Zilog) — created. 

• 840811 R. Weiaer (ORl) — conditional aaaenbly 



text: .sect 



NOTE 



The C portion of the BIOS is non-aegmentad. 

This aasefflbXy-language module la asaeoibied 
non-aegmented, and serves as the interface. 

Segmented operations are well- isolated, and 
are either the soaei as their non-aegmented 
counterparts, or constructed using macros. 



* The resulting code looks a little odd. 
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Liistmg B-6. (continued) 



l-xcernals 



.global __bioainit 

.if L0AJ3ER 

.global __ldcpm 

.else 

.global _flush 

•global ccp 

. end 1 f 

-Global rrapinic 



C portion mit 

If LOADER is True then 
Load the system into memory 

else its the normal bios 
Flush buffers 
Coffimand Processor 

end conditional 
trap startup 



global _psap, _^sysseg, __sysstk 



* Global declare tion« 



global bios 
i f LOADER 

else 

g 1 oba 1 _wboot 

end if 

global ___input 

alobal output 



initialization 

If Loader stub oui 

warn boot 

input a byce 
outout a bvte 



wboot 
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Liatincj B-6. (continued) 



* Bloe Initialization and Entry Point 
* 

* Thia is where control comes after boot. 

* If (the label LOADER is true I) 

* Control is transferred to -tdcpm 
; * else 

* Control is transferred to the ccp. 
* 

* We get here from bootstrap with: 

* segmented mode 

* valid stacJc pointer 

* valid PSA in RAM 



bioss 

; enter in segmented node. 

r Get system (PC) segment into r4 

DI VI.NVI 

calr kludge ; get PC segment on stack 
kludget popl rr4,.9rl4 

; get PSAP into rr2. 

Idctl r2 . PSAPSEG 
Idctl r3, PSAPOPF 

; go non-segmented. save PSAP, system segment. 
J system stack pointer (in system segment, please) 

i^lOfiiSEG 

Idl ^paap, tx2 

Id ^sysaeg, r4 

Id r'l4,_sysaeg 

Idl ^sysatk, rri4 

.if LOADER 
.else 
set up. system stack so that a return will warm boot 
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Listing B-6. (continued) 

push @rI5,#_wboot 
. endif 
; set up traps, then enable interrupts 

call _traDinit 
EI VI,NVI 

aetz up C part of Bios 

call _biosinit 

; Turn control over to. coaanand processor 
. 1 f LOADER 
3P _ldcpm : do Program load 

. else 

jp ccp 



* Warm Boot 

■» 

flush buffers and initialize Bios 
then transfer to CCP 



wooot : 




call 


flush 


call 


bios inlt 


Idl 


rrl4,_fy5stX 


IP 


ccp 



endif 
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Listing B-6. (continued) 



* 

* I/O port operations 

* 

* Int « input(port: int) 

* output (port, data: int) 



inputs 

• Id r2,ARGl(rlS) 

subl rr6 , rr6 

inb rl7,9r2 

Xdb rl6,rl7 
rat 



output: 

Ld r2,ARGl(riS) 
Id ^r3,ARG2(rlS) 
outto ;|r2,rl3 

c«t 
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liisting 5-7. BIOS I/O Routines 



* • ** « 



'■"*'•*' biosio.Skn for cpm.sys + cpmidr . sys ** 
Copyright 1984, Digital Research Inc. 

I/O routines for CP/M-8000 ( tm) BIOS 
* for Olivetti M20 (28001) system. 

"* 821013 S. Savitzky (Zilog) — created. 

' 840815 R. Weiser ( DRI ) — conditional aaaeabiy 



.ext: .sect 



• NOTE The Olivetti PROM routines are segmented. 

The C portion of the BIOS is non-segaented. 

* This assembly-language module is assesLbled 
non -segmented, and serves as the interface. 

Segmented operations are well-isolated. • and 
are either the same as their non-segmented 
counterparts, or constructed using macros. 



* Glooai declarations 



.global ^disk__io 
.global __crt_put 
.global ~cola]_boot 
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LiiAting B-7. (continued) 



* Prom Subroutiiitt Accoss 



disk ioi 



dec 
Idm 

Idta 

Idb 

Id 

id 

idl 



;err"di«k_io<drv, cad, count, blk, addr) 
;9ave registers 



rlS , »14 
€rl5,r8,#7 



rh7 , 14+ARGH-l { rl5 ) 
rl7,14+ARG2+L(rlS) 
ca, 14+ARG3(ri5) 
e9, 14+ARG4(rlS) 
rrlO,I4-»-ARGS(ri5) 



;get arga 



SE6 




seal! 


84000068h 


&K3NSEG 






;r9 




;rh7 




?ri7 




;rh6 


and 


t7,#0PFh 


Ida 


r8,3riS,#7 


Inc 


rl5,#i4 


ret 




crtjjut : 


;crt^ut(cha. 


dec 


ri5,*l4 


Ida 


3riS,c8,#7 


Id 


rl,14+ARGl(r 


S£G 




id 


rO.rl 


scaii 


a4000080h 


£IONS£G 





;rh7 « drive * 
;rl7 » coamand 
;ra « block count 
;r9 " block nusyDer 
;rrlO * segmented address 



block count not trams £er red 

fratrias 

final error code (RETURNED) 

error retried 

; value returned in r7 
; restore regs 



; save registers 



; SEG clobbers rO 
;rlO » char 
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Listing B-7 . (continued) 



idm r8,@ri5,#7 .-restore regs 
inc ri5,*14 

ret 



CCIG OOO-I 



SEG 

scail 8400008Ch 

NONSEG 

ret 
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Listiing B-a. Mttnocy ManageBttxxt Bias 



" bioaB«ja.Skn for cpm. sys > cpmldr.Ays 
Copyright 1984, Digital Research Inc. 



7* Menory Management for CP/M-dOOO( tn) BIOS 

£or Olivetti H20 (218001) system. 



. * 

. * 



7* 821013 3. Savitzky (Zilog) — split noduiea 

;* 820913 S, Savitzky (Zilog) — created. 

?* 840813 a. Weiser (DRI) — conditional assembly 



text: .sect 



This module copies data tram an€t memory space 
to another. The machine-dependant parts ot 
the mapping are well isolated. 

Segmented operations are welloiaoiated, and 
are either the same as their non-segmented 
counterparts, or constructed using macros. 



* (Slobal declarations 

* 



.global _^sysseg, ^asrseg, ^sysstK, josap 
. global memsc 



Externals 



global xfersc 
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Listing B-8. (continued) 



* System/User Memory Access 

* 

* _aicin_cpy ( source, dest, length) 
" " long source, dest, length; 

* ^niap__adr( addr, space) -> paddr 

"long addr; mt space; 

" _map_adr( addr, -1) -> addr 

* ~ "sets user seg* trom addr 

" _inap_adr( addr, -2) 

control transfer to context at addr. 

" system call: mem^cpy 

* rr6 : source 

dest 

length ( < length <» 64K) 

* recurns 

' registers unchanged 

* system call: inap__adr 

* rr6 : logical addr 

* r5: space code 

* r4: ignored 
rr2: 

returns 

* rrS: physical addr 



soace codes 




caller data 
caller program 
syscea data 
systco program 
TPA data 
TPA program 



x+256 x«l, 3,5: segmented I-space addr. 

instead o£ data access 

FFFF: set user segment 
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Listing 3-d. (continuttd) 



OlttBMC: 



;m«ittory manager ays ten call 

CALLED PROM SC 







• IN SEGMENTED MODE 






■ rr6 : source 






■ rr4t dest / space 






• rr2: length / 


1 t««tl 


rr2 




jr z 


m«iB_map 




astt^coFy: 


• copy data. 




. 


' rr6: «3urce 




1 


rr4 : dest 




. 


' rr2: length 


Idirb 


Sr4,(|r6,r3 




Ldl 


cr6,rr4 


• rr6 » dest +• length 


ret 






owm^map t 


; map address 






' rr6 s source 
r4: caller's s«g. 




1 


cS: space 

• c2: caller's FCW 


l^NSEG 




, 


cp 


r5,»-2 ; 


space«-2: xfer 


jp eq 


xfersc , ^.:v. 




Id 


r4,scs#g-*"4< rlS ) 




Id 


r2,aGlcwi»4(rl5) 




G&lr 


map 1 




ldl 


cr674(rl5),rr6 , 


return rr<6 


SEG 






ret 






map^l 1 




dispatch 


cp 


r5,*0FPFF*i 




jr eq 


s«t_,a«r 


apace*- 1; user a«g 


cpb 


ri5,#0 




jr eq 


call data 




cpb 


ClS,?l 




jr eq 


caii^prog 




cpb 


clS,*2 




jr eq 


ays data 




cpb 


riS7#3 




jr eq 


ays^rog 




cpb 


rl5,*4 




jff «! 


usr data 




cpb 


rl57#5 




jr eq 


uar^rog 





a-49 



:P'&:~aOQO Svstem Guide 



Sanoie 3I0S Wrirter. ir. C 



Listing B-8. (continued 



ret 



set usr : 



Id 
rei 



_usrseg , r6 



; default: no mapping 
;-l: set user seg . 



,w. T^r FOLLOWING CODE IS SYSTEM- DEPENDENT "• 

* rr6« logical address 

r4 « caller ' s PC segment 
r2 ■ caller ' s FCW 

* returns 

* rr6« napped address 

' Most of the system dependencies are m ittap__prc>g; 
' which maps a prograai segment into a data segment 

* for access as data. 



ca... 


. da ta : 








bit 




r2,#15 




ret 


nz 






Id 




r6, r4 




ret 






cal- 


. orog: 








bit 




r2. #15 




jr nz 


map_jjrog 




Id 




r6.r4 




jr 




map^rog 


sys 


da ta .- 








Id 




r6 . _sysseg 



segmented caller? 
yes — use passed seg 
no — use pc segment 
already mapped 



segmented caller? 
yes-- ' use passed seg 
no — use pc segment 
map prog as data 



ret 



>ys__prog : 
id 
ret 



data: 
Id 
cp 

ret eq 
Id 
ret 



r6, __sy33eg 



rO, ♦-! 

rO, _usrseg 

r6 , __usrseg 



assume sys does not 
separate code, data 
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£«isting B~8. (continued) 



um: prog« 
Id 



cp 

jr eq 
id 



rO, #-1 
rO, ^usraeg 
aapjprog 
r6, ^u«ra«g 
aap_^rpg 



aapjprogs 



«nd 



;au&p program «ddr into data 
; tr6 « addreae 



teatb rhS 
ret nz 



r6,#7FO0h 



; data aceeaa? 
; no I done 

; extract seg bits 



; Olivetti: legnent 3 ia the only one with 

aeparate X and spacaa, and 
; - ' the prograa apace- ia aeceaaed 
; aa segment 10 ' a data. 

cpb '.rh6 f #8 

ret ne 

Idb rh^.#10 

ret 
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Listing B-9 . BIOS Trap tiandlers 



'«'■«•-*•*•■■-«*•■«■»« 



biostrap. Skn cpm.sys + cpmidr . sys ♦•**•* 
Copyright 19S4, Digital Research Inc. 

Trap handlers for CP/M-8000 ( tm) BIOS 

321013 S. Savitzky (Zilog) — created 

321-23 D. Dunlop (2iiog) — added Oliverti K20- 
specific code to invalidate tracK buffer 
contents when disk drive motor stops 
(fixes directory-overwrite on disk change) 

8 30305 D. Sallume (Zilog) — added FPE trap 
code. 

840815 R. WEISER ( DRI ) — conditional assambiy 



r.axt: .sect 



NOTE 



Trap and interrupt handlers are started up 
in seamen ted mode. 



ixternais 



LOADER 



C oortion of Loader Bios 



.global _bios 

. else 

.global _ bios -• C portion of Normal Bios 

. end 1 f 

.global memsc : memory-management SC 

.global _tbvalid rdisk track buff valid 

-global _tbdirty ;disk track buff is dirty 

.global _5ysseg, uarseg, sysstk, ^sap, 

.if LOADER 

.else ; only the normal Bios 

-global fp^epu 

.endif 
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Listing B-9. (continued) 



* M-20 ROM scratchpad RAM addreaaas 

* 



rtc^ext: .aqu 32000022h 



motor jsn t * aqu 82000020h 



7 Place to put addrasa 
; of liat of functions 
; for each clock tick 
rOlsk motor timeout 



* Global declarations 

* 



.global ^trapinit 
.global ^rapvec 
.global ^trap 

.global xfarsc 



Systea Call and <3«neral Trap liandlar And Dispatch 

It is assuaed that the system runs 
non-segmented on a segmented CPl}. 

trap is jumped to segmented^ with the 
?ollowing information on the stack: 

trap typet WORO 

reason : WORO 

Sew : WORO 

pC : LONG 

The trap handler ia called as a subroutine, 
with all registers saved on the stack, 
IN SEGMENTED MODE, This allows the trap 
handler to be in another segment (with some 
care). This is useful mainly to the debugger 

All registers except rrO are also passed 
intact to the handler. 
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Listing B-9 . (continued) 

cext : . sect 

;c__t,rap: ; system call trap serve: 

push &rl4,(?rl4 



sub 


rl5, #30 


■ push caller state 


Idm 


§rl4,r0,«14 




NONSEG 




• go nonsegaented 


Idctl 


rl.NSP 




id 


nrl4(rl5) , rl4 




•ex 


rl.nrl5(rl5) 


trap* now in rl 


cp i3 


rhl,*7Fh 


sysceB call? 


3r ne 


rrap_disp 


no 

yes: map ir. 


Giro 


rhl 




add 


rl, tSCOTRAP 





==•==■ need ranoe check 



-an diSD: 
sli 
Idl 
testl 
:r 2 

pushl 

SEG 

popl 

calr 

3' 



pushl 
ret 



tl,#2 

rrO , _trapv(sc ( rl ) 

rrO 

_^trap_ret 

gri5,rrO 

rrO,arl4 

trap_l 

__t:rap_ret 

(arl4.rr0 



dispatch 



sero -- no action 
else call seg i?rrO 
(done via kludae) 



2P ?rrO 
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Listing 8-9. (continued) 



_trap_^ret: 

filOlirSEQ 



Id tl , nrlS { ri5 ) 

Id rl4,nrl4(rlS) 

Idctl firSP,rl 

SEG 

IdB r0,@rl4,»l4 

add rlS , »32 

Iret 



; return from trap or interrupt 
7 pop state 
; go segmented for the iret. 



? return from interrupt 



* Assorted Trap Handlers 

* 



epu^trap i 
" push 

^^. 

pi^trapj 
"" push 
jr 

seg^trap t 
"" push 

jr 

mBi___trap: 

push 



@rl4.*EPUTRAP 

_trap 

§ri4,#PITIU^ 

. ^trap 

3rl4,#SEGTRAf 
^trap 

?rl4,*tfMITl!lJVP 

trap 



if LOADEE 

.else 



;. not used in Loader Bios 



a-55 



.M-8000 Svsterr, Guide £ Sar.oie BIOS Written u 



Listiing B-9 . (continued] 



3ios svscem call handler 



biQssc: ;call bios 

MONSSG 

r3 « operation code 
rr4« PI 
rr6» P2 

Id rO, scfcw-^4{ riS ) ; if caller nonaeg, normal 
and rQ.*0C000h 
jr nz s«g___ok 

Ic r4 , sc5e5-^4.( rl3 ) r then add seg zo PI, ?2 
id r6, r4 



se:':2 OK : 



s»z up C Stack fraoe 



push! $rl5,rr6 

pushl ?rl5.rr4 

push @rl5,r3 

call bios 



call C program 



; cleaft stAck & return 
add rlS.flO 
idl cr6-*'4( ri5 ) , rr6 ; with long in rr6 

SEG 
ret 

. end if 
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Listing B-9. (continued) 



* Context Switch Syatea Call 

* 

* xf«r( context) 

* long context; 

* 

* context Is thei physical ( long ) address of : 

* ro 

« « 

* ri3 

* rl4 (normal rl4) 

* rlS (noriaal riS) 

* ignored word 

* FCW (had better sp<ici£y normal mode) 
;* PC segment 

;* PC offset 

* 

* the syatea stac)c pointer is not affected. 
« - 

* Control never returns to the caller. 

* 



xfersc: ; enter here tron system call 

SEG 

7 huild frame on system stack 

; when called from system call« the frame replaces 
.* the caller's context, which will never be resumed. 

inc rl5,#4 ; discard return addr 

Idl rr4,rrl4 ;mov« context 

id r2.*PHAMES2/2 

Idir (!r4,3r6,r2 

jr ^trap__ret ; restore context 
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Listing B-9. (continued) 



iaotor_c — check if disk motor still running. 

Entered each clocK tick. Invalidates 
track buffer when motor stops 
(Note: runs segiaentec) 



_jnct.ar_c : 

Idl rr4 , ♦motor__on .-Motor running? 

test 9r4 "" 

ret nz ;Yes: do nothing 

ida.r r4,5 

id rS, #_tbdirty ; Is track buff dirty? 

test 9r4 "" ; Yes. . . 

ret nz r ...return without invalidating 

Id r5, ?_tbvaiid 

clr »r4 ~ rNo: mark track buffer 

ret ; invalid 

Table of functions run each real time clock tick 

_t: : ck tab : 

-long -1 ;Will contain ^iaotor__c 

.word Otttfh ;TerxBxnator "* " 



• ^trapinrt — initialize trap system 



■« -,3 



SA ( Prograai Status Area) structure 



ps .equ S r size of a program status entry 

— — seomented — — 



a-58 



CP/M-8000 System Guide 



B Sample BZOS Written in C 



Liat;inig B-9. (continued) 



p»a_^«pu 


.equ 


I'ps 


psajprv 


.equ 


2*pa 


psa_sc 


.•qu 


3*p« 


p«a~s«g 


.•qu 


4*p« 


paa^nai 


.•qu 


S*pa 


paa^^nvi 


.«qu 


6*pa 


p«a~vi 


.•qu 


7*pa 


p«a~vac 


.•qu 


paa_ 



EPU trap offset 
prlviledged instruction trap 
system call trap 
segmentation trap 
non-masteabl* interrupt 
non-vectored interrupt 
vectored interrupt 
1/2} ; vectors 



_^trapinit: 

; initialize trap table 



Ida 
id 

subl 
clrtraps: 

Ldl 
inc 
djns 

Id 



r2 , trapvec 
rO , TntraPS 

rr4 , rr4 

§r2 , rr4 

r2 , #4 . 

rO , clrttaps 



c2,_sysseg 

mot used by Loader Bios 



.if LOADER 

.else 

Ida r3#bio88C 

Ldl ^trapveeH-< aiQS^SC+SCOTRAP ) *4 , rr2 

.endif "" "" 

Ida r3 , mease 

ldl trapvec-^iMEM SC'i-sC0TRAiP)*4,rr2 

.if LOADER 

.else r not used by Loader Bios 

Ida r3 . f p epu 

Ldl ^trapvec+EPUTRAP*4,rr2 

.endlf '" 

initialize some PSA entries. 

rrO PSA entry: PCW ( ints ENABLED) 

rr2 PSA entry: PC 

rr4 -> PSA slot 



Ldl 

SEG 
Ldl 



rr4,_jjsap 

rrO, *O00OD800h 



; traps here 
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Listing B-9. (continued) 

add r5,»ps ; EPU trap 

Idar r2,epu trap 

Idm 9r4/r07#4 

add r5,»ps ; Priviledged Inst 

Idar r2,pi_trap 

idro (?r4,rO,*4 

add r5,#ps ; Systeas Call 

idar r2, sc_trap 

idm @r4,rO.#4 

add r5,*ps segmentation 

idar r2,S€g__trap 

Ida @r4,r07»4 

add r5,?ps ; Non-MaskaJale Int. 

Idar r2 , nmi__t.rap 

idm Sr4,r07=^4 

>e.z. uD Real-Time Clock external call ioc 



idar 


r2, motor c 


idar 


r4, tick tab 


idl 


(3r4.rr2 


idl 


rr2,#rtc ext 


idl 


§r2.rr4 


NONSEG 




ret 
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Listing B-10„ Syateje-CaJLl Interface 



«««««*«««« syscall.Skn cpn.sya +• cpmidr.sya *******•> 

* Copyright 1984, Digital Res'uarch Inc. 
* 

* SyataB Call interface for CP/M-a000( ta) BIOS 
* 

* 820927 S. SavitzJcy (Ziiog) — created. 

* 840815 R. Weiaer (DRI) — conditional aeaembiy 



text: .aeet 



* fiK)TE 

* The following system call interface routinea 

* are designed to be called from non-aegmentod 

* C programs. 

* 

* Addreaaes are passed as LONGs. 



.global ^xfer 
.global 'ja»«^j=py 
.global ~map~adr 
.global 33 '•o' 
.global __bdos 
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Lisring B-10. (continued) 



*■ Context Switch Routine 

* xfer ( context ) 

* long context; 

* context is the physical (long) address of 

rO 

rl3 

* rl4 (normal ri4) 
riS (normal rl5) 
ignored word 

Few (had better specify normal mode) 
PC segment 
PC offset 

" The system stack pointer is not affected. 

' Control never returns to the caller. 



..cter : 



Idl 


rr6,ARGi(rlS ) 


Idl 


rr4,#-2 


subl 


rr2.rr2 


sc 


#xrER sc 


ret 
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tiiatixKg B-10. ( continuad ) 



SyBtam/Ut3«r Maaory Aecsss 



* __^ni««__cpy( sourca, d««t, length) 

* "" "iQOf sourca, d««t, length; 

* __Bap^aarT addr, spaca) -> paddr 

* "" "long addr; Int apaca; 

• 

* ^«ap_adr( addr, -1) 

* " ""sata usar sagaant # froa addr. 

* 

* map adr( addr* -2) 

* "" "tranafar to context block at addr 

* 

* system call: mam___cpy 

* rr6: aource 

* rr2: length (0 < length <- S4K) 

* returns 

* registers unchanged 

* systea call: map^adr 

* rr6: logical addr 



* 
• 
* 


rS: 

r4r 

rr2: 


Space coda 

ignored 

<3 


* 


retuma 


* 
• 


rr6; 


physical addr 


• 
* 


space codes: 
0» 


caller data 


• 


1: 
2: 


caller prograa 
systea data, 


« 
* 


3t 
4i 


system prograa 
TPA data 


* 


Ss 


TPA program 



X'»'256 return segmented instruction address, 
not data access address 

FFFF set user -space segment Crom address 
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Listing B-10. (continued) 

;copy memory C subroutine 

rre.Ai^Gl (rl5 ) 
rr4,ARG3(rlS) 
rr2,ARG5(rl5 ) 
*MEM_SC 

.-Dao address C subroutine 



Idl rre.AilGKrlS ) 

Id r5, ARG3(ri5) 

subl rr2,rr2 : length says map 

3C #MEM_SC 

ret 

.if LOADER 

•else not used by Loader Bios 



mejE 


_cpy: 


3:^S4£i 






idl 




idl 




idl 




sc 




ret 


cnan 


adr : 



* long _bio8(code, pi, p2 

* long ~todos(code, pi) 

* Tnt code r 
long pl^ p2; 

* BIOS, BOOS access 



Jios : 








Id 


r3,Ai^Gi(ri5 ) 




Idl 


rr4,AilG2{rl5) 




idl 


rr6,ARG4{ri5 ) 




sc 


#BIOS_SC 




ret 




3dos : 








Id 


r5,AKGitrl5) 




Idl 


rr6,ARG2(rl5) 




3C 


#BDOS SC 




rev 4 





endif 

End of Aooendix 5 
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APPENDIX C 
PUTBOOT Utility C L.anguage Source 

lasting e^l. Bootstrap liVritttr for thm 01iv«tti M2a 



CP/H»Z8K( ta) Boe«se»p trtlear tot Ch* OLXVITTX M30 (2S000) 
Cop3ri^^9ist 1984, Digital Etos«areh Xne. 



ohar •eopyrtt « "CP/M-ZBKC t») V«r. 1,1. Copyri^jht ISfl*. Digital Aasaareh Inc. 
ch*r 'ssrial - ••X3CXX->O00O-«5432i-; 



/• MSToinr 



330801 
S40SZ4 
340801 



f. Sl^taicU {Ziiog) — «ritt«n 
rtw isocli£i«d i,nclud«a 
etw aad* eo- look; gwiacic 



#inelud« "poirtato*}!' 

*tnelud« "oaiC.h" 

#ineiud« "sedlo.n" 

*ineluci« 'n»iio«.h'' 

*liwluila "xoach" 



*<l«fin« CSATA 
ids fin* OIRSEC 



»4«ein« srrnw lo 
«d«£in« scraisc 11 

*d«fin« BSC7DMA 13 
tdafim WSECrOR 14 

XADOR phyadir : 

struct dpba Idptor 
struct t»io«^ar« Ibp? 
XiVOOR phyaibpi 

•xirarn Long 9ap_adr< ) ; 



/* cpa.h and bdoa.h caplaoaa wieh 
/• oaif.h 03-15-84 ctw 



/* Paraaatar for aap adr( ) 

/* Paraaatar for SZ<^ writ* call 



/* SI08 Futietion 10 

/* 8X08 runetion 11 

/* BIOS Funetion 12 

/• aiOS Functimi 14 



Sat Track 
Sat Svecor 
Sat DMA A4dr 
Writ* Saoeor 



/* Sagaantad addr*as of dirtouf 

/* Oiak Paraaatar Bioelc */ 

/* 3X03 paraa Oloeic Cor BOOS call SO*/ 
/* phyaicai addcoaa of il9p atructuca*/ 

/• Function to caturn phyaical addr •/ 
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PUT300T Utility C Language Source 



Listing C-1. (continued) 



♦ .iei^ne BPLS 
*.l«:ine BPS 
»'ie:ine BPSO 
*;ietine SPT 
»'ie;in« L-SPT 
».se:in« SYSTRKS 

♦ 'ieiin« SYSSXSE 
^■aeiine STARTRK 



128 

256 

128 

16 

32 

2 

SPT'BPS-SYSTRKS 



," Byztts per locicai sector •/ 

/• Bycsa pex sector •/ 

/* Bytes per sector, tr)^ •/ 

'■• sectors per tracK •/ 

/* i.ogical sectors per trecK */ 

/* Nu«&«r of boot trac)c« '/ 

" Max siiB ol bootstrap */ 

,' * TrecK numoer to stArt on '/ 



char 



Un: 



syecodeCSrSSIZE]: 
*9y8tea ■ "CPMUJR.SYS" 



f Hold the entire bootstrap here i */ 
/• NesM o£ the prog to boot •/ 



struct 
■» t. - uct 



x_hdr 
daicnuB: 



xh; 



Drive nuaaer 0-15 • A-P •/ 



a«. -rn argc. «rgv> 
i.T: argc r 
',-1.1 r **rgvCj; 



reotistcr ->nt 
recLster char 
Ion? tsizc; 

int curiisk: 



•p: 



Good to reaeaber, fc reset'/ 



i£(ar9c i> 3) usa^et ) ; 

syatea ■ "-—'•ar^v; 

iK (dsicnuB - "'■*^argv - 'a') < II dafcnuB > IS ) [ 

princf ( "putBoot: Illegal drive ccxse Icn", •argvCO]); 

•Xitll ) ; 
J 

curdek • _ret_cdi«)c( ) : 

_get^4pb(i«p_adr( ( long) iidpb. CSA.TA)),- /• Phveaddr of idpb •/ 
Z.H I 2in - fopenb(«v»te«. "r")) — NUU.) I 

prineiK 'pucbooc: Can't opan booecerap ti.lt tan", avacea) 

«x i t ( 1 > .• 

faize ■ 01.: 
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Lisfcing C-l. (continued) 

/« raad fil* h««di«r */ 

p ■■ ( chac * ) &jch t 
for (i - Or 1 < Mizuotixh)} i**) 
•p-^ • (ch»r) 9«t:e<£ln); 

/* tmaA and count sagaMic h««d«rs to g«« Sila sis« */ 
for (i ■ Of I < xh.Jt_.na«4!; !•«•) I 
p ■ <char "j""*!**! 
«or( j • 0; j < aizmoHxm): j-H.) 
•p** " («h«r) g«tc(fia); 
m xm,x sqjcyf I" X^SG^SSS &« x«.x_,«g^ftyp J« X^SO^STX) 

if (falsa > SYSaiZE) ( 

printf ("Booeaerap toe blgn"); 

•sit(l); 
} 
•laa 

pclntf ("Booeatrap flia xa lid tsytaan". falsa); 
p • syacoda; 

/* If any othar spaelai iAfoeaacion is na«4«d' ae ftha bafiimiivi of tha */ 
/* systaa track of tha Loadac lo«.d thaii into tha syseoda araa ttam- '/ 

whil«< falsa-^-) [ 

if( (c ■ faec(fin)) •• eo») (' 

priaef<"tjinaxp«e«ad 50F in la. lid lafltn'^ayacaa* fa tsa) .- 
axit(^); 
] ■ V ■•■■■ - 'y^ :^... -^ V 

■?♦-♦• • <SJ . ■ ^. . ■■ 

) • * 

/• 

** At this point, tha anclra bootaerap prograe coda and data haa baan loadad 

** into ctia array naaad "syacodai", praeadad by a buneti of PCOS gartMvga 

** which tha OLivatcl boot PROM axpaecs to finsl thara. Hou wa tiaa diracc 

** BIOS ealla to writa tha syaeoda array out to tha prepar ar«« on ditX. 

** for tha Ollvacti. this ia cracKa I and 2. slnoa track ia tpaeial. 

•/ 

puct>oot( ayacoda ) ; 

printf ( "Sootaerap haa baa:n wrltean.a"); 
sal dlak(eurdak) ; /* raaalact original diak*/ 
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Listing C-1 . (coatiaued) 

pur.b30t( cod« ) 
ch&r 'cod«; 

register xnt i ; /• Eandy Lndsx */ 

re9i«t«r j.nt ni»«c»; /• i logical ••ctors in boot*/ 

r««isc«r ch«r "p; /' ptf lo n«xt p«.rt of coae */ 

LHt track: /• Currant crack '/ 

int saceor: .'• Currant sector •/ 

phvBibp " ■ap_a<lr( { iang ) fcibp. CDATA )r 

niaaca • STfSTRKS • I^PT ; " /• aisa / log a«C9 p*r srK •/ 

/* Pauaa for cha uaar co maart disk ■/ 
p«uaa(clrvn«jia) ; */ 

"■ 'ur coda hare whan crkO aaccO ara ap«ei*l •/ 
" to i _aai_diak in.r tha drive you mtutt •/ 

" tnan eai.! putblk trKO, aacrO, and the addraaa c£ aactor mtormation * / 
p ■ coda : 
for!: • 0: ; c niaaear : — ) : 

traCK - STXfiTRK - ;/:^F?: 
sector ■ ili-SPT; 
pctbik{ track, aactot. p) : 
3 -" SPUS: 



' .-uncEion to aaiact a given crack tor writing on, on the current diak. 

" naKea uaa of the 3DQS direct BIOS e&lJ. to laaua Bios function 10. 

ae'icrkl n) 
irsi n; 

ibp.req - SCTTRK; /• BIOS request number 10 •/ 

ibp.pA ». (long) ns /• oaraaeeer • track t •/ 

_bioa_c«.H( phyaibp ): /• Pass sag ibp addreaa •/ 
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Liatiing C-1. (continued) 

/• 

• r-tsastiwi to put blocJc i <tt tth« boot tr»cJt. 
•/ 

putblk(tz)c. aee. *ddr) 
int trk. Aoei 

char *addr7 

{ 

twtgimtmt iae at 

••ljli«ic(dalcnuB)7 /* aei^ot «• currant disk •/ 

7«etx)c(tr)c) ; 

a » amc * it /* ••etoe nuabvf •/ 

ibp.raq - SSTSKC; /• ilOS c*qu«ac mjab«r 11 */ 

iSapopL - <lonq) n; /• para«»t«r - sactoc » •/ 

j9ioa^cail( phyalbp ) ; /* Pa** »mq ibp addrasa V 

/• Saetor is new aae; now sac daa addraas. */ 

ibp.iraq • METCMAl> /* 3X08 Ra<tuaa« nuabar 12 */ 

ibp.fti " aap adr( (ion?) addr, OSATA); 

" /* parma * sag addraaa of C/o buffar */ 

^bioa^caAiC phyalbp ) ; /• Cali ilO« •/ 

/* Ham eaa do a writ* */ 

itif.smq - «a«CT01l» /• «I0» Raquaat nuab«c L4 •/ 

ibp.pi - OIRSW:; /* CcHBpiaea wrica taaadiataiy •/ 

btois cali( phyaibp )t /"Do ifei •/ 

,.. J . - - 

./• * -^ : 

* It cha usajr invokad ua Mith t]iia wrw«9 oaadMir at a«9«* • • 
•/ 

aa«f •< ) 

prla«£( "Uawyat paebooc (tilaawia> «drlvaeoda*n'') ; 
axitd) i 

i ■' 



Snd of Afipandix C 
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bringing up CP/M-8000, $-2 



Absolut* , I'-2 
aiaioluts data 

doim-Ioadf $-2 
addrvasr 1-2 
address spao«# I*i 
algorithms, 4->20 
allocation v«otor, 3-3 
ALV, S-3 

applications prograiBSr 1«S 
ASCII cJjaractsc, l-«, 4-9 
ASCII CTRL-Z MAS)/ 4-11 
AinaiilARY XSIPOT dsvics, 4-24 
AOXILIAHY OOTFOT dsviCS, 4-24 



a 



hmmi paga, ^l-2r--l>S - 

BDOS » 1-4 , 1-5 , 1-7 , 2-1 , S- 2 

01 r act BIOS Function, 4-1 

function 61 Sat Sxcsption 

factor » 4-28 

SIOS, 1-4, 1-5, 1-7, 3-2, 4-1 

BIOS £lush buffars oparation> 

S-10 
BIOS Function 

Initialiaationv*4-4 
2 Consols Status, ;4-#^:' 

1 Raad Consola d^staetajr,'-' 
4-7 

4 ffrlta Consols Char ac tar, 
4-a 

5 List Charactas Outputs 4-9 

6 Auxiliary Output, 4-10 

7 Auxiliary Input, 4-ii 

8 Home, 4-12 

9 Select Disk Drive, 4-13 

10 Set TracK Muraber , 4-14 

11 Set Sector Number, 4->l5 
L2 Set DMA Address, 4-16 

13 Read Sector, 4-17 

14 Write Sector, 4-18 

15 Return List Status, 4-19 

16 Sector Translate, 4-20 

18 Get Address o£ MRT, 
4-21, 4-22 

19 Get I/O 3yte, 4-23 



20 Set I/O 8y,t.®> 4-26 

22 Set Exception Handler 
Address, 4-28 
BIOS function 

called by BDOS, 4-1 

Eomm (8) , 4-14 
BIOS 

compiled, 2-1 

creating, 5-1 

interface, 5-1 

internal variables, 4-4 

label, 7-1 

register usage, 4-2 

write operation, 5<<flO 
BLM, 5-5 
block mask, S-5 
block number 

largest allowed, S-€ - 
block shift factor, 5L-S 
block size, 5-6 
block storage, X^Z 
BIiS , 5— € ^ 

3i;>S bytes, 5-10 
boot 

disk, 3-4, 6-1 

tracks, 5-6 

warm, 5-10 
bootstrap 

loader, 1-7, 8-1 

machine dependent, 5-<6 

procedure, 3-1 
bootstrap loading, 3-1 
BSH, 5-5 
bss, '1-2 
buffer 

writing to ^isk, 5-9' 
byte, 1-2 
byte (8 bit) value, 5-5 



carriage return, 4-8 
CBACS feature, 7-1 
CCP, 1-4, 1-5, 1-7, 2-1, 6-2 
CCP entry point, 4-5 
character devices, 1-6 
checksum vector, 5-3 
CKS, 5-5 
cold boot 

automatic command execution, 
7-1 
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czeazmq , 3-2 

loader, 2-i 
cold start, 1-7 
coiwnunicatxon protocol, 4-9 
configuration requirements, 6-1 
conout, 3-3 
CONSOLE device, 4-24 
context block, 4-33 
CP/M-8000 

configuration, 5-1 

customizing, 2-1 

file structure, 1-1 

generating, 2-1 

i.nstaiiing, 6-1 

loading, 6-1 

locic&i devic« 

chacacteristicSf 4-24 

nieaory model, 1-| 

progranoning modeij 1"»2 

jivsteiB modules* 1-4 
CPM.REZ., 2-1 
CPM.SYS, 1-7, 3-1 
CPM.SYS file, 7-1 
CPK. SYS 

creating, 2-1 
CPKLDR, 3-2 
CPMLDR.SYS, 3-2 

auilding, 3-3 
CPMLIB, 2-1 
CSV, 5-3 • 
CTRL- 2 (lAH) , 1-6 



Disk Parameter Header (DPH) , 
3-3, 4-1, 4-13, 4-20, 
5-2, 5-3 

disk select operation, 4-13 

disk throughput, 5-8 

disk writes, 4-27 

DMA address, 4-16 

DMA buffer, 4-18 

DPB, 5-2 

DRM, 5-5 

DSM, 5-5, 5-6 



end-of-file, 1-6 
end-of-file condition, 4-11 
error indicator/ 4-13 
ESM, 5-6 

exception vector, 4-28 
extent masK , 5-S 



file storage, 1-6 

file system tracks, 5-6 



Get MRT, 3-3 
I 



data segment, 1-2 
device models 

logical, 1*'6 
DIR3UF, 5-2 
directory buffer, 3-3 
dirsctory check vector, 5-5 
diSK, 1-7 
disK access 

sequential, 5-9 , 
disk buffers 

writing, 4-27 
disk ■■ 

definition tables, 5-1 

devices, 1-6 
disk 

drive 

total storage capacity, 5-5 
disk head, 4-12' 
Disk Parameter Slock (DPB) , 
3-3, 4-1, 4-13, 5-4, 5-6 

fields, 5-5 



I/O 

byte, 4-23 

byte field definitions, 4-25 

character, 1-5 
I/O byte devices 

character, 1-6 

disk drives, 1-6 

disk file, 1-5 
Init, 3-3 
interface 

hardware, 1-5 
interrupt vector arear 1-4 



jsr _init, 4-4 

L 



LD8K command, 2-1 

LDRLIB, 3-2 
line-feed, 4-8 
list device, 4-9 
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LIST dsvicOf 4-24 
loadac BIOS 

writing, 3-2 
loadttc syatttm library , 3-2 
logical 

addraaa, 1-2 

aaetor nunbaring, S-3 

aagiMitt saparationr 1-5 
Iongword# 1-2 
longword Talaa, 4-4, 5-2 
LHor baffar raplacanaztt, 5-9 
LB0 buifars, 5-10 



map addraaar 4-31 

map iK9dzaaaing# 1-S* 

napping 

logical to physical, 5-3 

map ftdr, 1-5 

naxlAtxB track nuxabar 
6353S, 4-14 

mwBory block copy, 1-S 
abaoluta, 2-1 
copy, 4-30 . :■■, :,: vv.:t 

location ' "■ :^^'- ;'■■:')■'" 

{oanagamant, 4-1, 4^iS 

aamory rag ion tabia, 4'-2I 

aa«jcpy, 1-5 

nibbla, 1-2 



OPT, 5-S 

OFF paraaiatar, S-2 
off sat, 1-2 

Olivatti M20, 3-€, 6-1 
output davica 
auxiliary, 4-10 



parsing 

coRooand Unas , 1-5 
physical 

addrass, 1-2 

sactor, S-9 
PIP 4—25 
PUTBOOT utility, 3-2, 3-4, 8-1 



raad, 3-3' 

raad/writa haad, 5-8 
SSAOHE fila, 6-2 
ragiona, 4-21 
rag is tar contants 

daatroyad by BIOS, 4-1 
raloeatabla, 1-2 
raaacvad tracks 

RUBbar of, 5-5 
UST, 3-2 

raturn coda valua, 4-17 
rotational latency , 

S-3, 5-8, 5-9 
cts instruction, 4-4 



S 



SC #1: ^ .t'-b'-ir. v#\ 

. -nap addra8a:i^^4-31- .:%z:j'iv 
'N:'. jfflamory copy, . 4-:30;;c',--s^V 
^■;'#at TPA sagiaant, 4-32'-! 
/ /-transfar control, -4-3$: ;; 
-scratchpad 
■■ :>araa, ,5-2 ■ 

; ■''Words, 5-2 ^■..■^>- %..:;.« 
■liactor , 1-6 
■sactor nujabars . 

unskawad, 4-lS 
sactor skewing, 8-1 . 
sactor translate tabXa, 5-3 
sactor <■'■■ 

128-byta, 1-6, 5-7 
sactran, 3-3 
segment, 1-2 
saldak, 3-3 
set axcaption, 3-3 ':*''^-' 
set TPA segment, 4-32 
jMtdma, 3-3 
aetsec, 3-3 
settrk, 3-3 
SETTRK function, 4-12 
SPT, 5-5 

SPT parameter, 3-2 
STAT, 4-25 
systam 

address space, L-5 

calls, 4-1, 4^-28 ' 

disk, 1-7 

generation, 1-7 

node, L-2 , 
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operating mode/ 1--5 
stacK area, 1-5 



text segnien't., ■ 1-2 
TPA. ■-!• 

t r ac K D Q.: .pos.t tiqn ,■ At- 12 ■ ' 
transtuj-; controi,,' v^-^iS ■"' 
transient .-p.iT'Ogp.aja,' i-'2" ' 
transient program area, l."5 

translate •.table, r4"20 
trap ■■ 

hfl.ndler ,■ ■ 3-?,.., 

VfeCtOC , ■4-4- ;. ./j_,;' " 

trap >nit:.alizatibn, 3-2 
turn-<ey systems, 7^-1 



user ,■■.■• 

-;-ic.er£acr.«,; l-.^ 

user cananands 
b'u..lt-in, 1-5 

warm boot,. 5-lQ-v, ., 
word, 1-2 ■ ■ .., "" ,^ ; 
il6-bit) value, 5^-2 
keferences, 4-26 

X 

XLT, 5^2 

a u tost, 7-.i 
Jeep, 4-5: • . , 
_iri.:t,- At A 
™init routine, 7-1 

usercjnd, 7-1 
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